Live Share 插件需手动安装微软官方版本，常见失败原因包括网络拦截、插件冲突及WSL GUI未启用；协作需在项目根目录启动、显式授予权限并配置调试共享，企业内网须放行指定域名。
Live Share 插件装不上或启动失败
VSCode 官方实时协作功能靠 Live Share 插件实现，不是内置功能。很多人在扩展市场搜“协作”“共享”找不到它，是因为名字就叫 Live Share，且必须由微软官方发布（作者名是 Microsoft）。装不上常见原因有三个：
- 网络被拦截：国内某些环境访问
marketplace.visualstudio.com不稳定，建议用离线方式——去官网下载最新.vsix文件，再通过 VSCode 的「从 VSIX 安装」手动导入 - 插件冲突：如果同时装了
CodeStream或旧版Telemetry类插件，可能触发权限拒绝，卸载后再试 - WSL 环境未启用 GUI 支持：在 WSL 中运行 VSCode 时，
Live Share启动会报Failed to launch browser，需确保已配置WSLg或使用 Windows 版 VSCode 连接 WSL
邀请链接打不开或参与者看不到文件
协作失败最常卡在这步：你点「Start Collaboration Session」生成链接，对方点击后进不去、白屏、或只看到空编辑器。这不是插件问题，而是权限和上下文没对齐：
- 你必须在项目根目录下打开 VSCode（即
code .启动），不能只打开单个文件；否则 Live Share 只共享当前文件，不带工作区配置、.vscode/settings.json和调试任务 - 对方加入后默认无编辑权限，要你在右下角状态栏点
Share Access→ 选Can Edit才能改代码 - 如果用了符号链接（比如
ln -s ~/src/myproj ./myproj），Live Share 会因路径解析失败拒绝共享，改用真实路径打开项目
调试时断点不生效或控制台乱码
协作中调试是高频痛点，尤其涉及 Python/Node.js 等解释型语言。根本原因是调试器进程未被正确代理：
- VSCode 默认只转发编辑操作，调试会话（
launch.json）需显式开启共享：在调试配置里加"__liveShare": true字段，否则断点只在你本地命中 - 终端输出中文乱码，大概率是参与者系统 locale 不一致，可在
.vscode/settings.json中统一设为："terminal.integrated.env.linux": { "LANG": "en_US.UTF-8" } - Python 调试依赖
ptvsd或debugpy，Live Share 会自动注入，但如果你禁用了扩展自动启用（extensions.autoUpdate: false），需手动确认Python插件已启用
企业内网无法连接 Live Share 服务
公司防火墙常拦截 vscode-dev.live-share.com 和 prod.wss.live-share.com，导致「Connecting…」一直转圈。这不是配错，而是协议层被阻断：
- Live Share 强制走 WebSocket over HTTPS（wss://），不支持 HTTP 代理或自定义 endpoint，没法像 AI 插件那样换 TaoToken 地址
- 唯一合规解法是让 IT 部门放行上述两个域名 + 端口 443，或部署内部 Live Share 网关（需 Azure DevOps Server 2020+ 支持）
- 临时替代方案：用
code --install-extension ms-vsliveshare.vsliveshare-pack命令行安装，有时比图形界面更可靠（尤其在远程桌面场景）
Live Share 的协作边界很明确：它同步的是编辑意图和调试状态，不是文件系统。你删掉一个文件，对方不会立刻看到，要等你保存并触发文件事件；而 Git 操作、终端命令、外部构建工具完全不共享——这些得靠团队约定或额外工具补位。
