VSCode Live Share“版本不兼容”是因双方主版本号（MAJOR.MINOR）不一致，如1.94与1.90；需统一升级至相同稳定版（如1.94.2），或清理缓存后降级匹配，并重启Live Share服务。
VSCode 实时协作（Live Share）报“版本不兼容”，通常不是插件本身要更新，而是你和协作方的 VS Code 主版本号不一致——比如一方是 1.94.2，另一方是 1.90.0，而 Live Share 要求双方主版本（MAJOR.MINOR）必须相同。直接更新到同一稳定版即可解决，不用降级或手动改包。
确认双方 VS Code 主版本是否对齐
Live Share 的兼容性检查在连接瞬间触发，错误提示类似 Version mismatch: expected 1.94.x, got 1.90.x。它只比对 MAJOR.MINOR（如 1.94），不看 PATCH（如 .2）。所以 1.94.0 和 1.94.3 可以协作，但 1.94.3 和 1.93.5 就会失败。
- 各自在 VS Code 中按
Ctrl+Shift+P→ 输入Help: About查看完整版本号 - 重点关注前两段数字，例如
1.94.2的主版本是1.94 - 如果版本差一个
MINOR（如1.93vs1.94），必须有一方升级或降级
优先升级到最新稳定版（推荐）
截至 2026 年 10 月，最新稳定版是 1.94.2（每月第一个星期二发布）。升级后不仅解决 Live Share 兼容问题，还能用上新 API 和安全补丁。
- Windows/macOS：顶部菜单
Help → Check for Updates，有更新就点Restart and Install Update - Linux（deb/rpm 包安装）：需手动下载新版
.deb或.rpm并重装，旧配置自动保留 - 别依赖扩展视图里的“更新”按钮——那是更新插件，不是更新 VS Code 本体
如果对方无法升级，你可临时降级到匹配版本
企业环境或受限机器可能禁用了自动更新（比如组策略设置了 UpdateMode=2），此时你得主动降级。但注意：降级 ≠ 重装旧包，必须清理残留数据，否则启动时仍加载新版本缓存。
- 先完全退出 VS Code（包括后台进程，Windows 可在任务管理器中结束
Code.exe） - 去官网
https://code.visualstudio.com/updates/找对应MAJOR.MINOR的旧版下载链接（如v1.93.0） - 安装前手动删除
%USERPROFILE%\AppData\Roaming\Code\Cache（Windows）或~/Library/Caches/com.microsoft.VSCode.ShipIt（macOS） - 重装后首次启动会重建缓存，Live Share 连接成功率显著提升
更新后仍提示不兼容？重点查这三处
版本号对上了还报错，大概率是 Live Share 插件没同步刷新，或者本地服务卡在旧状态。
- 重启 VS Code 后，再打开命令面板运行
Live Share: Restart Service - 检查状态栏右下角是否有
Live Share图标，点击它确认当前会话状态是否为 “Active” - 如果使用了自定义
proxy或企业防火墙，确保https://insiders.vscode.dev和wss://prod.liveshare.vsengsaas.visualstudio.com未被拦截
真正卡住的点往往不在版本号本身，而在服务进程没 reload、缓存没清干净、或网络路径被截断。只要主版本对齐 + Live Share 服务重启 + 网络通路正常，协作就能立刻恢复——不需要碰 package.json 或改任何插件源码。
