Live Share 协作失败可按五步排查：一、重装启用扩展；二、强制刷新 Microsoft/GitHub 登录；三、启用直连模式绕过 Azure 中继；四、清除扩展与工作区缓存；五、安装扩展包并禁用冲突插件。
如果您在 VSCode 中启用 Live Share 协作功能时无法成功发起或加入会话，则可能是由于扩展未正确安装、身份验证失败、网络中继连接受阻或权限配置异常。以下是解决此问题的步骤：
本文运行环境：MacBook Pro M3，macOS Sequoia
一、重新安装并启用 Live Share 扩展
该方法通过彻底重置扩展状态，排除因缓存损坏、版本冲突或初始化失败导致的协作中断问题。
1、打开 VSCode，按下 Ctrl+Shift+X 进入扩展市场。
2、在搜索框中输入 Live Share，定位到由 Microsoft 发布的官方扩展。
3、点击已安装项右侧的卸载按钮，确认卸载完成。
4、重启 VSCode，再次搜索并安装该扩展，安装后不重启直接点击启用。
二、强制刷新身份验证会话
Live Share 依赖 Microsoft 或 GitHub 账户进行端到端身份校验，令牌过期或账户权限变更将导致链接生成失败或加入拒绝。
1、点击 VSCode 左下角用户头像图标，选择 Sign out 退出当前账户。
2、按下 Ctrl+Shift+P 打开命令面板，输入并执行 Live Share: Sign in。
3、在弹出的浏览器窗口中使用同一 Microsoft 账户完成授权，并勾选 Allow access to your account。
4、返回 VSCode，等待右下角状态栏出现绿色 Live Share signed in 提示。
三、绕过 Azure 中继直连本地网络
当企业防火墙或代理拦截 Azure 通信服务域名时，Live Share 会话建立超时；启用直连模式可利用 P2P 协商跳过中继服务器。
1、按下 Ctrl+, 打开设置界面，在搜索框中输入 liveshare.enableDirectConnection。
2、勾选该配置项，将其值设为 true。
3、保存设置后，重新启动协作会话，观察控制台是否输出 Using direct connection mode 日志。
四、重置共享工作区上下文缓存
VSCode 会为每个 Live Share 会话缓存项目结构、打开文件列表及调试配置；若缓存损坏，协作者可能无法加载正确文件树或断点失效。
1、关闭当前所有 VSCode 窗口，确保后台进程完全退出。
2、在终端中执行：rm -rf ~/.vscode/extensions/ms-vsliveshare*（macOS/Linux）或删除对应 Windows 路径下的扩展目录。
3、手动清空 VSCode 用户数据目录中的 WorkspaceState 子文件夹内容。
4、重新打开项目文件夹，再启动 Live Share 会话。
五、切换至扩展包完整版并禁用冲突插件
基础版 Live Share 可能缺失终端共享、语音通道或服务器映射等关键组件；同时部分插件（如某些代码格式化工具）会在协作时触发不可序列化操作，引发同步崩溃。
1、在扩展市场中搜索 Live Share Extension Pack，安装该官方合集包。
2、按下 Ctrl+Shift+P，执行 Extensions: Show Enabled Extensions。
3、临时禁用以下类型插件：Prettier、ESLint、Auto Rename Tag、GitLens（非必要时）。
4、重启 VSCode 并测试协作会话是否可稳定建立与同步。
