VS Code需通过官方Live Share插件实现实时协作，它支持毫秒级同步编辑、调试、终端和语音通话，且端到端加密不上传代码；Git和共享文件夹因异步性与冲突问题无法替代。

VS Code 本身不内置实时协作功能，必须通过官方插件 Live Share 实现——这是目前唯一被微软官方支持、能真正同步编辑、调试、终端和语音通话的方案。

为什么不能只靠 Git 或共享文件夹

Git 是异步协作，提交/拉取有延迟，无法看到对方光标位置或实时输入；共享文件夹（如 Dropbox、NAS）会导致文件锁冲突、保存覆盖、扩展状态不同步（比如断点、折叠状态）。Live Share 是端到端加密的 P2P 连接（可选中继），所有操作毫秒级同步，且不上传代码到服务器。

安装与基础启动流程

确保双方都安装了 VS Code（1.60+）和 Live Share 插件（在扩展市场搜 “Live Share”，认准 Microsoft 官方发布）。启动协作只需三步：

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

• 发起方按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并运行 Live Share: Start Collaboration Session
• 选择是否共享终端、服务器、音频等（默认只共享编辑器），点击“复制链接”
• 邀请方粘贴链接到浏览器或 VS Code（会自动跳转），登录同一 Microsoft 账户（或 GitHub）即可加入

常见卡点与绕过方式

国内用户常遇到连接失败或“Waiting for host…”无响应，本质是 P2P 打洞失败。优先尝试以下顺序：

• 关闭本地防火墙或杀毒软件的实时防护（尤其 360、火绒）
• 在 VS Code 设置中搜索 liveshare.allowGuestToJoin，设为 true（避免被默认策略拦截）
• 若仍失败，在设置中启用 liveshare.useRelay（强制走微软中继服务器，速度略慢但稳定）
• 禁用所有非必要插件（特别是自定义语言服务器、远程开发类插件），它们可能干扰 Live Share 的进程注入

注意：Live Share 不同步用户级设置（如主题、快捷键），只同步工作区行为；如果对方看不到你的断点，请检查是否开启了 liveshare.debugging 并确认调试配置未被工作区设置覆盖。