VS Code实时协作依赖Live Share插件,通过点对点或中继连接实现光标、编辑、终端及调试会话共享;需双方安装官方插件、登录兼容账号(微软或GitHub),且网络允许wss://连接。

VS Code 实时协作靠的是 Live Share 插件,不是靠 Git 推送、不是靠共享文件夹、也不是靠第三方远程桌面。它直接在编辑器内建立点对点或中继连接,让多人实时看到彼此光标、编辑、终端、甚至调试会话——前提是双方都装了插件且登录了兼容账号。
安装 Live Share 插件与登录验证
插件必须从 VS Code 官方扩展市场安装,认准作者是 Visual Studio Live Share(微软官方)。装完重启编辑器后,左下角会出现小人图标,点击它会弹出登录选项。此时不要选 Sign In With User Code——这个路径在新版中已失效;必须选 Sign In With Browser,它会打开系统默认浏览器,跳转到微软或 GitHub 登录页。登录成功后,VS Code 左下角小人图标会变蓝,并显示你的头像缩略图。如果点开没反应、或一直卡在“Signing in...”,大概率是系统代理或企业防火墙拦截了 https://vsls.azure.com 域名,需临时关闭代理或添加例外。
开始协作会话:共享项目、终端、服务的实操要点
只有打开一个真实文件夹(即工作区)后,Start Collaboration Session 才可用。点击后,插件会生成一个带有效期的 HTTPS 链接,形如 https://vsls.azure.com/join/abc123...。这个链接可发给协作者,也可复制进浏览器手动打开。注意:
• 共享项目时,对方看到的是你本地的完整文件树,但不会自动同步文件变更——所有保存仍发生在你本地磁盘
• Share Terminal 会把当前集成终端(比如 bash/zsh)实时投射过去,对方能看见命令输出,但不能输入(除非你主动开启“Terminal Input”权限)
• Share Server 是指转发你本地启动的 TCP 服务(如 localhost:3000),对方访问自己的 localhost:3000 就等同于访问你的服务,但前提是你的服务监听的是 0.0.0.0 而非 127.0.0.1
加入协作会话时常见失败原因
对方发来的链接点开后,VS Code 弹窗提示 “Unable to join session” 或直接跳转失败,通常有三个硬性条件没满足:
• 你本地未安装 Live Share 插件,或版本低于 v1.0.5965(2024 年后发布的旧版可能不兼容新协议)
• 你尚未登录,或登录账号类型不匹配(比如分享人用 GitHub 登录,而你只绑了 Microsoft 账号,此时需统一用同一平台登录)
• 你的网络策略禁止 WebSocket 连接(Live Share 底层依赖 wss://),企业内网常见;可尝试切换至手机热点验证是否为网络问题
真正容易被忽略的一点是:Live Share 不传输代码文件本身,而是传输编辑操作指令流。这意味着如果一方开了 ESLint 自动修复、Prettier 保存格式化、或任何会触发文件写入的插件,另一方会实时看到光标跳动和内容变化,但不会触发对方本地的格式化规则**——他们的编辑器配置完全独立。所以别指望靠协作来“强制统一团队格式”,那得靠 .prettierrc + editorconfig + 提交前 CI 检查。











