Live Share 无法协作时,需依次检查扩展状态、Azure 认证、防火墙/代理设置及本地缓存。具体步骤:一、启用或更新 Microsoft 官方扩展并重启;二、通过命令面板登录 GitHub/Microsoft 账户并验证状态;三、临时关闭防火墙,配置代理直连 VS Eng 域名;四、删除 globalStorage 中 Live Share 缓存文件夹后重试。

如果您在使用 VSCode 的 Live Share 功能时无法成功发起或加入协作会话,则可能是由于扩展未正确安装、网络策略限制、身份验证失败或权限配置异常。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、检查 Live Share 扩展状态与更新
Live Share 功能依赖于官方扩展的完整安装与激活,若扩展处于禁用、损坏或版本过旧状态,将导致协作功能完全不可用。
1、打开 VSCode,点击左侧活动栏中的扩展图标(方块拼图形状)。
2、在搜索框中输入 Live Share,确认官方扩展名称为“Live Share”且发布者为 Microsoft。
3、若显示“已禁用”,点击右侧启用按钮;若显示“更新”,点击“更新”完成升级;若未安装,点击“安装”并等待完成。
4、安装或更新后,重启 VSCode 以确保扩展初始化完成。
二、验证 Azure 身份认证状态
Live Share 强制要求用户通过 Microsoft 或 GitHub 账户登录 Azure 认证服务,未完成登录或令牌过期将直接中断会话建立流程。
1、按下 Cmd + Shift + P(Mac)调出命令面板。
2、输入并选择 Live Share: Sign in with GitHub 或 Live Share: Sign in with Microsoft。
3、在弹出的浏览器窗口中完成授权,返回 VSCode 后观察右下角状态栏是否显示已登录的账户邮箱前缀。
4、若状态栏无提示,执行 Live Share: Check Authentication Status 命令进行诊断。
三、调整防火墙与代理设置
Live Share 默认使用 TLS 加密连接 Azure 中继服务,企业网络或本地防火墙可能拦截其使用的端口(如 443、3240)或域名(*.liveshare.vsengsaas.visualstudio.com),导致连接超时。
1、打开系统设置中的网络防火墙选项,临时关闭防火墙进行测试。
2、若使用代理软件(如 Clash、Surge),在代理配置中添加 *.vsengsaas.visualstudio.com 到直连规则列表。
3、在 VSCode 设置中搜索 liveshare.proxy,将其值设为 system 或手动填写代理地址(如 http://127.0.0.1:7890)。
4、重启 VSCode 并尝试重新启动 Live Share 会话。
四、重置 Live Share 本地配置与缓存
本地存储的会话元数据、加密密钥或临时证书若损坏,可能导致协作握手失败,清除相关目录可强制重建可信上下文。
1、退出 VSCode 完全关闭所有实例。
2、在 Finder 中按下 Cmd + Shift + G,输入路径:~/Library/Application Support/Code/User/globalStorage/ms-vsliveshare.vsliveshare。
3、将该文件夹整体移至废纸篓(不需清空,保留备份以便回溯)。
4、重新打开 VSCode,执行 Live Share: Start Collaboration Session 触发全新初始化流程。











