VS Code 需通过微软官方 Live Share 扩展实现实时协作;安装后重启,点击状态栏 Share 按钮启动会话;共享范围限当前工作区,权限可实时调整;调试与终端需手动启用;连接失败多因网络拦截核心域名。

VS Code 本身不内置实时共享编辑功能,必须依赖 Live Share 扩展——这是微软官方提供的、唯一被深度集成且稳定支持的协作方案。
如何安装并启动 Live Share
在 VS Code 中打开扩展面板(Ctrl+Shift+X 或 Cmd+Shift+X),搜索 Live Share,安装由 Microsoft 发布的官方扩展。安装后重启 VS Code(部分版本需重启才生效)。首次使用时,点击左下角状态栏的 Share 按钮(或按 Ctrl+Shift+P 输入 Live Share: Start Collaboration Session)即可发起会话。
- 发起者无需登录 Microsoft 账户也能启动会话,但对方加入时可能需要临时授权(取决于安全策略)
- 若状态栏无
Share按钮,检查是否禁用了扩展,或执行命令Developer: Toggle Developer Tools查看控制台是否有Failed to activate extension ms-vsliveshare.vsliveshare类错误 - Linux 用户如遇
libglib-2.0.so.0: cannot open shared object file,需手动安装系统依赖(如 Ubuntu 上运行sudo apt install libglib2.0-0)
共享范围与权限控制很关键
默认只共享当前打开的文件夹(workspace),不自动包含外部路径或符号链接目录。权限分为 Read、Write、Owner 三级,可在邀请链接生成后点击右下角 Live Share 状态图标实时调整。
- 被邀请者无法看到你本地未打开的文件,除非你主动用
File: Open Folder加载并共享整个目录 - 调试会话(
F5)默认不共享;如需协同调试,发起者必须勾选Share Debugging选项(在启动会话前的弹窗中) - 终端(Terminal)默认不共享;启用需在设置中开启
"liveshare.featureSet": "insiders"并重启,再手动启用Share Terminal
常见连接失败原因和绕过方式
最常遇到的是 Unable to connect to Live Share service 或邀请链接打不开,本质是网络策略或代理拦截了 vs-liveshare.azureedge.net 和 prod.wss.live-share.com 这两个核心域名。
- 企业内网用户:联系 IT 部门放行上述域名,或配置 VS Code 的
http.proxy设置(注意:不能只设系统代理,必须显式写入 VS Code 设置) - 国内用户:确认没有启用“仅限中国区服务”限制(检查设置中
"liveshare.region"是否为""或"global") -
防火墙/杀毒软件误杀:临时关闭 Windows Defender 实时防护,或添加
Code.exe到白名单
Live Share 的真正门槛不在安装,而在于网络可达性与权限粒度的理解——很多人卡在“点了 Share 没反应”,其实问题不在 VS Code,而在 DNS 解析或 TLS 握手阶段就被静默阻断了。










