应更新 Live Share 扩展、重置身份验证令牌、调整 防火墙 与代理设置、启用中继服务器模式。具体包括:更新扩展或重启用,执行 Sign Out/Sign In 重获令牌,禁用冲突代理并放行 端口3218,勾选 Relay: Enabled 强制使用微软中继。

如果您在团队开发中需要与同事实时共享代码编辑环境,但发现协作过程中存在权限同步延迟或会话连接不稳定的问题,则可能是由于 Live Share 扩展配置不当或网络策略限制。以下是解决此问题的步骤:
本文运行环境:macBook Pro,macOS Sequoia。
一、检查并更新 Live Share 扩展版本
Live Share 依赖于最新版扩展以兼容 VS Code 核心协议变更和安全补丁,旧版本可能无法建立稳定会话或触发身份验证失败。
1、打开 VS Code,点击左侧活动栏的扩展图标(方块拼图形状)。
2、在搜索框中输入Live Share,确认已安装扩展名称为“Live Share”且发布者为“microsoft”。
3、若右侧显示“更新”按钮,点击执行更新;若无该按钮,右键扩展条目选择“禁用”,再右键选择“启用”以刷新插件状态。
二、重置 Live Share 身份验证令牌
身份令牌过期或损坏会导致加入会话时提示“未授权”或自动退出,重置可强制生成新凭证并绕过缓存冲突。
1、按下 Cmd+Shift+P 调出命令面板,输入并选择“Live Share: Sign Out”。
2、重启 VS Code,再次调用命令面板,输入并选择“Live Share: Sign In”。
3、在弹出的 浏览器 窗口中完成 Microsoft 账户登录,返回 VS Code 后等待状态栏右下角出现 Live Share 就绪 提示。
三、调整 防火墙 与代理设置
Live Share 默认使用 websocket 直连,若企业网络启用了深度包检测或代理拦截,会话握手阶段即被中断,需显式放行相关 端口 与域名。
1、在系统设置中打开“网络”→“高级”→“代理”,确认“自动代理配置”未启用,或确保 PAC 脚本不拦截 vscode-live-share.com 与vscode-webview.net。
2、打开终端,执行 sudo pfctl -sr | grep 3218,验证本地防火墙是否放行 Live Share 默认端口 3218;若无输出,需编辑/etc/pf.conf 添加 pass inet proto tcp from any to any port 3218 并执行sudo pfctl -f /etc/pf.conf。
四、切换会话托管模式为中继服务器
当协作者处于 NAT 后或双向穿透失败时,p2p直连不可用,强制使用微软中继服务器可绕过本地网络拓扑限制,保障基础协作功能可用。
1、打开 VS Code 设置(Cmd+, ),搜索liveshare.relay。
2、勾选 Live Share > Relay: Enabled 选项。
3、断开当前会话,在命令面板中执行“Live Share: Start Collaboration session”,新会话将自动通过中继通道建立。