VS Code 实时协作必须使用官方 Live Share 扩展，需微软账户登录、双方网络互通且权限配置正确；安装后登录，发起者生成邀请链接，加入者点击链接并授权即可协作，终端与调试共享需手动开启，安全风险需通过权限控制和工作区清理防范。
VS Code 本身不内置实时协作功能，必须依赖 Live Share 扩展，且需微软账户登录、双方网络互通、权限配置正确——缺一不可。
安装并启用 Live Share 扩展
这是唯一官方支持的实时协作方案，由 Microsoft 维护，深度集成于 VS Code。其他第三方插件（如 Teletype）已停止维护或不兼容新版 VS Code。
- 打开 VS Code，进入扩展市场，搜索
Live Share，确认发布者为Microsoft - 点击安装，重启 VS Code（部分版本需重启才生效）
- 首次启动后，右下角会提示登录微软账户；若未弹出，手动执行命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Live Share: Sign in with Browser - 登录后，状态栏右侧会出现
Live Share图标（两个重叠的人形）
发起共享会话与加入方式
共享是单向发起、多端加入的模型，没有“房间号”概念，只有邀请链接。被邀请方无需提前安装插件（但实际必须已装好，否则点开链接会跳转到扩展页）。
- 发起者点击状态栏
Live Share图标 → 选择Start Collaboration Session - 默认共享当前工作区（含文件树、终端、调试器等），可点击弹出面板中的齿轮图标调整：关闭
Share Terminal或Share Debugging可减少资源占用和权限暴露 - 生成的邀请链接形如
https://prod.liveshare.vsengsaas.visualstudio.com/join?xxxxxxxx，通过 IM 或邮件发送 - 加入者点击链接 → 自动用 VS Code 打开 → 若未登录微软账户，会引导补登 → 接受权限请求（如访问文件、运行终端）后即加入
常见连接失败原因与排查
90% 的“连不上”问题不是网络或防火墙导致，而是权限或配置层面的疏漏。
-
ERR_CONNECTION_REFUSED或 “无法加入会话”：检查发起方是否已成功登录微软账户（Live Share: Show Account Status可验证） - 加入后看不到文件树或编辑无响应：被邀请方可能点了“只读模式”，需在右下角状态栏点击
Live Share图标 → 选择Join as Guest→ 切换为Join as Collaborator - 终端无法共享：发起方未勾选
Share Terminal，或加入方禁用了该能力（liveShare.features.terminal设为false） - 调试器无法同步：双方 VS Code 版本相差过大（建议都使用 Stable 版本），或被邀请方未安装对应语言的调试扩展（如 Python、C#）
权限控制与安全边界
Live Share 默认不授予写权限，所有协作行为需显式授权。但一旦授予权限，对方可编辑任意打开的文件、执行终端命令、甚至触发本地任务——这既是能力，也是风险点。
- 发起共享前，用
File > Close Workspace清理无关项目，避免误共享敏感路径 - 敏感操作（如
git commit、修改.env文件）建议在共享前明确告知，并开启Read-only by default设置（在设置中搜索liveshare.defaultGuestRole，设为ReadOnly） - 退出协作只需点击状态栏
Live Share图标 →Stop Collaboration Session；被邀请方关闭窗口即自动断开，无需额外操作 - 企业环境若启用了 Azure AD 条件访问策略，可能拦截 Live Share 流量，需确保允许
*.vsengsaas.visualstudio.com域名
Live Share 的协作粒度很细（光标位置、编辑选区、终端输入都实时同步），但它的稳定性高度依赖两端 VS Code 的扩展兼容性。遇到卡顿或不同步，先禁用非必要扩展（尤其是主题、格式化类），再重试——这点容易被忽略，却往往是关键所在。
