VSCode实时协作本质是Live Share协议栈本地激活后通过WebRTC 3.0直连建立端到端加密会话;需主机装扩展、登录Microsoft/GitHub账号、打开项目,执行“Live Share: Start Collaboration Session”即可启动,无需服务器中转或额外插件。

VSCode 实时协作不是靠“连服务器”或“装一堆插件”启动的,它本质是 Live Share 协议栈在本地激活后,通过 WebRTC 3.0 直连建立端到端加密会话。只要主机装好扩展、登录账号、有项目打开,Live Share: Start Collaboration Session 一按就开——没中间环节,也不依赖远程中继转发。
Live Share 扩展必须登录才能用
很多人点开命令面板搜到 Live Share: Start Collaboration Session 却提示“未登录”,是因为 VSCode 2026 默认禁用未认证会话(安全策略升级)。不登录 Microsoft 或 GitHub 账号,按钮灰掉、链接不生成。
- 必须用
Sign In With Browser(不是 User Code),否则 OAuth 流程中断,后续所有共享功能失效 - 登录状态保存在本地凭证管理器,重启 VSCode 不丢失;但换设备/重装系统需重新登录
- 如果团队用企业 Azure AD,需提前在组织策略中启用
liveshare.allowEnterpriseAccounts
共享范围选错会导致协作者看不到终端或断点
启动会话时弹出的“共享范围”三选一,不是功能多就好——它直接决定协作者能操作什么。默认只共享编辑器,终端、调试器、本地服务器 都被排除在外。
- 选“仅编辑器”:协作者只能看/改代码,无法运行
npm run dev,也看不到你设的断点状态 - 选“含终端/调试器/本地服务器”:协作者可执行命令、单步调试、访问你
localhost:3000的服务(注意:端口映射由 WebRTC 自动协商,不走 host 端口转发) - 选“完整工作区”:连
.vscode/settings.json权限都开放,协作者能改你的格式化规则、ESLint 配置——敏感项目慎选
协作者打不开链接?检查浏览器和 VSCode 版本兼容性
生成的链接形如 https://vscs.live/abc123?sig=xyz&exp=1748765200,协作者点击后跳转失败,常见原因不是网络问题,而是版本卡点。
- 主机 VSCode 必须 ≥ 1.94(2026 Q3 正式版),旧版无法生成带签名的 HTTPS 链接
- 协作者浏览器必须支持 WebRTC 3.0(Chrome 128+、Edge 128+、Firefox 126+),Safari 17.6 是最低要求
- 如果协作者用 VSCode Insiders,需确保其 Live Share 扩展版本 ≥ 1.0.7210(2026 年 9 月起强制校验协议版本)
- 微信/钉钉内嵌浏览器点击链接后白屏?必须手动复制链接 → 粘贴到系统默认浏览器打开
最易被忽略的一点:协作会话里“终端共享”默认关闭,即使你选了“含终端”的共享范围,也要手动在设置里打开 "liveshare.terminalSharing": true,否则协作者看到的终端是空的。这个开关不在 UI 里,只认 settings.json 配置。


















