VSCode Live Share 协作失败时，需依次检查扩展状态与更新、账户登录与授权、防火墙与代理设置、重置会话配置、启用详细日志定位错误。
如果您在使用 VSCode Live Share 进行多人实时协作时遇到连接失败、无法加入会话或代码编辑不同步等问题，则可能是由于扩展未正确配置、网络策略限制或权限设置异常所致。以下是解决此类问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、检查 Live Share 扩展状态与更新
Live Share 功能依赖于官方扩展的正常安装与最新版本支持，旧版扩展可能不兼容当前 VSCode 内核或服务器协议，导致会话初始化失败。
1、打开 VSCode，点击左侧活动栏中的扩展图标（方块拼图形状）。
2、在搜索框中输入 Live Share，确认已安装由 Microsoft 发布的官方扩展。
3、若右侧显示“更新”按钮，点击执行更新；若显示“禁用”，先点击启用。
4、重启 VSCode，确保扩展加载完成。
二、验证账户登录与身份授权
Live Share 要求用户通过 Microsoft 账户或 GitHub 账户完成身份认证，未登录或令牌过期将导致无法创建或加入共享会话。
1、按下 Cmd + Shift + P（Mac）调出命令面板。
2、输入并选择 Live Share: Sign in with Microsoft 或 Live Share: Sign in with GitHub。
3、在弹出的浏览器窗口中完成授权流程，返回 VSCode 后确认右下角状态栏显示用户头像图标。
4、若已登录但状态栏无响应，执行 Live Share: Sign out 后重新登录。
三、调整防火墙与代理设置
Live Share 使用 WebSocket 和 TLS 加密通道连接 Microsoft 的中继服务，本地防火墙、企业代理或安全软件可能拦截其流量，造成连接超时或拒绝。
1、临时关闭系统自带防火墙：进入“系统设置”→“网络”→“防火墙”，点击“关闭防火墙”。
2、在 VSCode 设置中搜索 http.proxy，若值非空，右键点击该项选择“在 settings.json 中编辑”，将其设为 null。
3、打开终端，执行 curl -v https://insiders.liveshare.vsengsaas.visualstudio.com/health，确认返回 HTTP 200 状态码。
四、重置 Live Share 会话配置
本地缓存的会话元数据或损坏的凭据文件可能导致新会话无法启动，清除相关配置可恢复默认行为。
1、退出所有 VSCode 实例。
2、在 Finder 中按下 Cmd + Shift + G，输入路径：~/Library/Application Support/Code/User/globalStorage/ms-vsliveshare.vsliveshare。
3、将该文件夹整体移至废纸篓。
4、重新启动 VSCode，再次尝试创建 Live Share 会话。
五、启用详细日志以定位具体错误
Live Share 提供内置诊断日志功能，可捕获从连接请求到身份协商全过程的底层信息，帮助识别被忽略的异常环节。
1、按下 Cmd + Shift + P，输入并选择 Live Share: Open Log。
2、复现问题操作（如点击“开始协作”）。
3、在日志窗口中查找包含 ERROR 或 Failed to connect 的行，重点关注紧邻其前后的 URL 与状态码。
4、若出现 403 Forbidden，说明组织策略禁止了 Live Share 服务访问，需联系 IT 管理员确认白名单配置。
