VS Code 需通过 Microsoft 官方 Live Share 扩展实现协作编辑;安装后重启,登录账号启动会话,共享范围限当前工作区,默认仅可编辑或只读,终端与调试需手动启用,数据经微软加密中继,不支持离线或自动冲突合并。

VS Code 没有原生的“实时共享编辑”功能,你实际需要的是 Live Share 扩展——它提供的是基于服务端中继的协作会话,不是纯 P2P 实时同步,也不等同于 Google Docs 那种无感协同。
如何安装并启动 Live Share 会话
必须先在 VS Code 中安装官方扩展:Live Share(由 Microsoft 发布,ID:ms-vsliveshare.vsliveshare)。安装后重启 VS Code,点击左侧活动栏的 Live Share 图标,或按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Live Share: Start Collaboration Session 并执行。
- 首次运行会提示登录 Microsoft 或 GitHub 账户(用于身份校验和权限控制,不涉及代码上传到其服务器)
- 启动后,底部状态栏会出现
Live Share按钮,点击可复制邀请链接 - 被邀请方只需用 VS Code 打开该链接(或粘贴进命令面板执行
Live Share: Join Collaboration Session),无需提前安装扩展(VS Code 会自动提示并安装)
共享范围与权限控制的关键参数
默认只共享当前工作区(folder),不共享终端、调试器、本地设置或未打开的文件。权限分为 Can Edit 和 Can View 两种,由主持人在邀请链接生成后通过右下角状态栏的 Live Share 按钮调整。
- 共享终端需手动启用:主持人执行
Live Share: Share Terminal,且对方必须已加入会话 - 调试会话仅支持“主持人单步调试,观众只读查看”,无法由观众发起断点或修改变量值
- 若使用 WSL、Docker 或远程 SSH,
Live Share仍以主机环境为准,不自动透传远程上下文
常见连接失败原因和绕过方式
错误信息如 Unable to connect to Live Share service 或 Failed to join session 多数与网络策略有关,而非配置错误。
- 企业防火墙常拦截
https://insiders.liveshare.vsengsaas.visualstudio.com等域名,可联系 IT 开放liveshare.vsengsaas.visualstudio.com及其子域 - 使用代理时,VS Code 必须已正确配置
http.proxy设置项,且代理需支持 WebSocket(wss://) - 国内用户直连不稳定,可尝试在
settings.json中添加:"liveshare.serviceRegion": "asia"(注意:该配置项非公开文档,仅部分版本支持,无效时请忽略)
Live Share 的核心限制在于:所有数据流经微软中继服务器(加密传输),不支持离线协作,也无法替代 Git 协作流程——编辑冲突不会自动合并,改同一行仍会相互覆盖。真正需要“实时感知光标/选区”的场景,得靠第三方插件(如 CodeStream)或自建 WebRTC 方案,但稳定性与权限模型完全不同。











