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 权限项。
三、调整防火墙与代理设置
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。











