Live Share插件因VSCode大版本更新导致API不兼容而被自动禁用,需完全退出VSCode、卸载旧版、下载最新.vsix并用code --install-extension命令行强制安装;若启动崩溃或功能异常,则需排查插件冲突、防火墙端口、代理设置、杀毒软件拦截及语言服务器协同配置。

Live Share插件显示禁用或“Requires version X.X.X but got Y.Y.Y”
VSCode官方实时协作插件 ms-vsliveshare.vsliveshare 在大版本更新后(如 1.94 → 1.95)常因 API 兼容性校验失败被自动禁用,界面显示灰色图标,并提示版本不匹配。这不是网络问题,而是 VSCode 主进程拒绝加载旧版扩展包。
必须完全退出所有 VSCode 实例(包括托盘后台进程),再用命令行强制重装:
- 关闭所有窗口,右键任务栏图标 → “退出”,或在终端执行
code --status确认无残留进程 - 卸载旧版:
code --uninstall-extension ms-vsliveshare.vsliveshare - 从官网下载最新
.vsix(地址:https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare → “Download Extension”) - 安装:
code --install-extension ./vsliveshare-1.0.7278.vsix(注意用绝对路径,避免ENOENT)
启动时报“Extension host terminated unexpectedly”且日志里有 liveshare 相关错误
该错误往往不是 Live Share 单独导致的,而是它与某些插件(如 ms-python.python、esbenp.prettier-vscode 或旧版 GitLens)存在进程级冲突。Live Share 的 Extension Host 是独立子进程,一旦某个插件触发内存泄漏或未捕获异常,整个协作宿主就会崩溃。
临时恢复协作功能的最快方式是隔离环境:
- 新建空文件夹,用
code --disable-extensions --user-data-dir=/tmp/vscode-ls-test启动纯净实例 - 仅安装
ms-vsliveshare.vsliveshare和ms-vsliveshare.vsliveshare-audio - 若此时能正常加入会话,说明原工作区存在插件冲突;可逐个禁用非必要插件排查
- 重点检查是否启用了
autoSave: "afterDelay"+ 大型项目,这会加剧 Extension Host 负载
已安装但点击“Share”按钮无响应,或邀请链接生成后对方无法加入
Live Share 依赖本地服务端(vsls-agent)和微软中继服务器通信。常见卡点不在插件本身,而在系统级配置:
- 检查防火墙是否放行 TCP 端口
32168(默认 agent 端口),Linux/macOS 可用lsof -i :32168验证 - 确认没有自定义
http.proxy或https.proxy设置——Live Share 不走 HTTP 代理,强行配置会导致握手超时 - 若使用企业网络,需确保域名
*.vssps.dev.azure.com和*.live-share.com可解析且未被拦截 - Windows 用户注意:杀毒软件(尤其 McAfee、Bitdefender)常静默拦截
vsls-agent.exe,需手动添加信任
协作中代码高亮/跳转失效,或 IntelliSense 显示“Loading…”一直不结束
这是 Live Share 的“共享上下文”机制与语言服务器(如 Pylance、clangd)未对齐的典型表现。协作会话中,Host 端的语言服务不会自动暴露给 Guest,Guest 默认只获得只读文件流。
要启用完整语言功能,必须显式配置:
- Host 端打开
settings.json,添加:{ "liveshare.featureSet": "full", "liveshare.languageServer": "host" } - Guest 端需安装对应语言插件(如 Python 项目必须装
ms-python.python),但无需配置解释器路径——它复用 Host 的运行时 - 若仍无效,检查 Host 的
c_cpp_properties.json或pyrightconfig.json是否含相对路径(如"${workspaceFolder}/include"),协作时这些路径在 Guest 侧不可解析,应改用绝对路径或环境变量
Live Share 的复杂点在于它不是单纯“装个插件就通”,而是一套跨进程、跨网络、跨权限边界的协同协议。最容易被忽略的是 Guest 端语言插件版本必须与 Host 兼容——比如 Host 用 Pylance v2024.12,Guest 若装了 v2023.8,IntelliSense 就会静默降级为基础文本分析。


















