VSCode需通过Microsoft官方Live Share插件实现实时共享编辑，所有参与者须登录Microsoft账户并安装该扩展；启动后生成24小时有效链接，支持调试与终端协同，但依赖本地环境一致。
VSCode 本身不内置实时共享编辑功能，必须通过官方插件 Live Share 实现，且需要所有参与者登录 Microsoft 账户并安装对应扩展。
安装与基础启动 Live Share
直接在 VSCode 扩展市场搜索 Live Share（由 Microsoft 官方发布），安装后重启。首次使用会提示登录 Microsoft 账户（支持 Outlook、GitHub 关联账号）。登录成功后，状态栏右下角出现 Live Share 图标，点击即可启动会话。
- 启动后自动生成一个可分享的链接，含唯一会话 ID，有效期默认 24 小时
- 被邀请者无需提前安装项目依赖或配置环境，只要装了同版本 VSCode 和 Live Share 插件即可加入
- 若点击后无反应或提示“无法启动服务”，常见原因是企业防火墙拦截了
localhost:3215（Live Share 后端本地代理端口），需临时放行或切换网络
共享范围与权限控制
默认只共享当前打开的文件夹（工作区），不上传代码到云端——所有编辑流量走点对点或微软中继服务器（加密传输），但源码始终保留在本地。
- 发起者可在共享前点击
Share Options自定义：是否允许访客终端控制、调试、数据库查询、甚至共享音频（用于语音协作） - 访客默认只有“只读 + 编辑”权限；如需限制某人仅查看，发起者可在会话中右键其名称 →
Change Permissions→ 选Read Only - 不支持按文件或文件夹粒度屏蔽共享（例如隐藏
.env或node_modules），敏感文件需提前关闭标签页或使用多根工作区隔离
调试与终端协同的实操要点
Live Share 支持跨用户调试和终端共享，但行为与本地调试有差异，容易误判断点失效或终端输出错乱。
- 调试时，所有参与者看到同一套断点和变量状态，但仅发起者能操作“继续”“步进”等控制按钮；访客可右键变量 →
Copy Value或Debug Console执行表达式 - 共享终端默认为发起者的 shell 环境（如 zsh / PowerShell），访客输入命令实际在发起者机器执行；若需各自运行本地命令，应关闭终端共享（在状态栏点击
Live Share→Stop Sharing Terminal） - Node.js 调试中，若访客看不到源码映射（显示
VMxxx），大概率是发起者未启用sourceMaps: true或未生成.map文件
常见连接失败与静默卡顿问题
Live Share 连接失败通常不报明显错误，而是表现为“已加入”但光标不显示、编辑无响应、或调试器卡在“launching”——这多与网络协商或本地服务冲突有关。
- 检查
Live Share输出面板（View → Output → Live Share）：若出现Failed to connect to relay server，说明中继不可达，可尝试在设置中启用"liveshare.allowTcpTunneling": true强制直连 - Mac 用户遇到持续“connecting…”：可能被系统隐私设置阻止了辅助功能访问，需前往
System Settings → Privacy & Security → Accessibility手动添加 VSCode - 共享大型 monorepo 时编辑卡顿：关闭不必要的扩展（尤其 ESLint、Prettier 的实时校验），或在
settings.json中添加"liveshare.suppressDiagnostics": true暂停远程诊断上报
Live Share 的协作深度取决于本地环境一致性——比如 TypeScript 版本不匹配会导致访客端无法正确跳转定义，而这类问题不会触发错误提示，只会让功能“看起来没反应”。务必在共享前同步 node_modules 和语言服务器版本。
