VS Code连接Live Share反复报错，寻求详细排查与解决方法

一、查看Live Share日志 #

• 打开VS Code命令面板（快捷键：Ctrl+Shift+P / Cmd+Shift+P）
• 输入并执行 Live Share: Open Logs Folder
• 在打开的文件夹中，查看 vsls.log 文件，其中包含连接过程的详细错误信息，是排查核心依据

二、网络配置验证 #

• 测试核心服务连通性：在终端执行 ping global.liveshare.vsengsaas.visualstudio.com，或用 telnet global.liveshare.vsengsaas.visualstudio.com 443 确认443端口可正常访问
• 代理检查：在VS Code设置中搜索 http.proxy，确认代理配置无误；若不确定，可临时关闭代理后重试连接

三、版本与扩展兼容性检查 #

• VS Code版本：优先使用最新稳定版，避免使用Insider预览版，旧版本可能存在已知兼容性bug
• 扩展冲突排查：禁用所有非Live Share类扩展，仅保留 Live Share 和 Live Share Audio（若安装），测试连接是否恢复；正常则逐个启用扩展，定位冲突项
• Live Share版本：在扩展面板找到Live Share，确认是最新版本；若最新版有问题，可在扩展详情页选择「安装另一个版本」，回退到上一个稳定版测试

四、实用修复步骤 #

1. 清除扩展缓存 #

• 完全关闭VS Code
• 删除对应目录下的Live Share缓存文件夹：
  • Windows: %USERPROFILE%\.vscode\extensions（删除所有以 ms-vsliveshare. 开头的文件夹）
  • macOS/Linux: ~/.vscode/extensions（同上）
• 重启VS Code，重新安装Live Share扩展

2. 更新依赖 #

• 打开命令面板，执行 Live Share: Install Dependencies
• 等待依赖安装完成后，重启VS Code再测试

3. 防火墙与安全软件设置 #

• 检查系统防火墙，确保VS Code进程及 vsls-agent.exe（Windows）被允许通过防火墙的入站/出站规则
• 临时关闭第三方杀毒、安全软件，排除拦截导致的连接失败

五、常见报错及解决方法 #

• "Failed to connect to the Live Share service"：排查网络连通性，确认443端口未被封锁，代理配置正确
• "Authentication failed"：执行 Live Share: Sign Out 后重新登录，或更换登录方式（微软账号/GitHub账号）
• "Could not start the Live Share agent"：清除扩展缓存并重新安装依赖；Windows系统需确认已安装.NET Framework 4.7.2及以上版本

六、高级排查思路 #

• 启用详细日志：在VS Code设置中搜索 liveshare.logging.level，设置为 Trace，重现问题后查看日志获取更详细的错误堆栈
• 重置VS Code设置：执行 Preferences: Reset Settings（注意备份自定义设置），恢复默认设置后测试
• 系统权限检查：Windows下以管理员身份运行VS Code；macOS/Linux下检查VS Code对扩展目录的读写权限

内容的提问来源于stack exchange，提问作者alonge peter