Live Share 无法发起或加入协作会话，需依次检查扩展状态与更新、验证账户登录与权限配置、调整防火墙与代理设置、重置 Live Share 会话服务。
如果您在使用 VSCode 的 Live Share 功能时无法成功发起或加入协作会话，则可能是由于扩展未正确安装、网络策略限制或身份验证状态异常。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、检查 Live Share 扩展状态与更新
Live Share 功能依赖于官方扩展的正常加载与最新版本支持，旧版扩展可能存在协议不兼容或认证模块失效问题。
1、打开 VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。
2、在搜索框中输入 Live Share，确认已安装由 Microsoft 发布的官方扩展。
3、若显示“更新”按钮，点击执行更新；若仅显示“禁用”，先点击启用，再重启 VSCode。
二、验证账户登录与权限配置
Live Share 要求用户通过 Microsoft 或 GitHub 账户完成身份绑定，并授予实时协作所需的 OAuth 权限，未授权将导致会话创建失败。
1、按下 Cmd + Shift+P（Mac）调出命令面板。
2、输入并选择 Live Share: Sign in with GitHub 或 Live Share: Sign in with Microsoft。
3、在弹出的浏览器窗口中完成登录，并勾选 Access your user profile 与 Join and manage collaboration sessions 权限项。
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
三、调整防火墙与代理设置
Live Share 使用 WebSocket 和 TURN/STUN 协议建立点对点或中继连接，企业网络或本地代理常拦截相关端口或域名，造成连接超时。
1、在 VSCode 设置中搜索 liveshare.allowGuestsToUseProxy，将其设为 true。
2、打开命令面板，执行 Live Share: Configure Network Settings，选择 Use system proxy 或手动填写代理地址与端口。
3、如使用公司网络，联系 IT 部门确认是否放行 *.vscliveshare.com 与 *.vsls.io 域名及 TCP 端口 443 和 3218。
四、重置 Live Share 会话服务
本地 Live Share 后台服务进程可能因异常终止而处于僵死状态，导致新会话无法初始化，需强制终止并重建服务实例。
1、在终端中执行 killall -u $USER vsls 清除所有残留进程。
2、关闭 VSCode 全部窗口，包括后台隐藏的 Helper 进程（可通过活动监视器搜索 vsls 确认）。
3、重新启动 VSCode，再次尝试发起 Live Share: Start Collaboration Session。
