VSCode版本不兼容主因是engines.vscode字段语义化匹配失败，需通过命令面板筛选Disabled插件确认，并修改.vsix中extension/package.json的vscode版本范围（如">=1.85.0”），再重打包安装；装完仍英文须检查locale.json是否为{"locale": "zh-hans"}并彻底重启。
VSCode版本不兼容问题几乎都卡在engines.vscode字段匹配失败上，不是插件坏了，也不是你装错了，而是VSCode启动时直接拒绝加载——它连日志都不写，只默默禁用或报“not compatible”。
怎么看是不是版本不兼容导致的？
别猜，先验证。打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入Extensions: Show Installed Extensions，点右上角筛选器选Disabled。如果目标插件（比如ms-ceintl.vscode-language-pack-zh-hans或esbenp.prettier-vscode）出现在这里，且详情页顶部写着Disabled，基本就是它了。
再补一刀：终端执行code --version，记下输出（如1.90.2）；然后看插件错误信息里是否含not compatible with VS Code '1.xxx'，且版本号对不上——这就坐实了语义化版本（semver）校验失败。
- 控制台（
Help → Toggle Developer Tools → Console）刷出Extension 'xxx' is not compatible with Code '1.90.2'红字 - 插件齿轮菜单显示
Disable (For All Workspaces)，但你没手动点过 - 运行插件命令（如
prettier.format）报command 'prettier.format' not found
怎么快速修复 .vsix 离线安装的兼容性报错？
离线场景下双击安装或拖进扩展面板必然失败——引擎校验在安装阶段就触发，绕不过。必须解包、改配置、重打包。
步骤很固定：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）打开xxx.vsix文件（它本质是 ZIP） - 进入
extension/package.json（注意：不是根目录那个package.json） - 找到
"engines": { "vscode": "^1.103.0" }这一行，改成你当前版本能接受的范围，例如："vscode": ">=1.85.0"（推荐，兼容宽）或"vscode": "^1.90.0"（若code --version输出是1.90.2） - 保存后，把整个文件夹重新打包为 ZIP，再把后缀名改回
.vsix - 命令面板运行
Extensions: Install from VSIX，选这个改过的文件
特别注意：Windows 下别用资源管理器双击解压再拖拽保存，会破坏 ZIP 结构；macOS 用 Archive Utility 解压时勾选“保留资源分叉”，否则可能丢 locale 资源。
为什么装了中文包还是英文界面？
装对了 ≠ 生效。VSCode 不靠插件自动切换语言，它只读locale.json里的值。即使中文包已启用、版本也改对了，只要这个文件不存在、写错、或被更高优先级设置覆盖，界面就一定是英文。
检查路径：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
合法内容只能是：{"locale": "zh-hans"}（注意不是zh-cn，写错就报invalid locale value）
改完必须完全退出 VSCode（包括托盘进程），再重新启动。如果之前用过 Remote-SSH 或 Dev Containers，还要确认远端环境的locale.json也同步更新了——远程窗口有自己的用户配置路径。
Remote-SSH 连接卡在 “Starting VS Code Server” 怎么办？
这不是网络问题，是远端vscode-server二进制和本地 VSCode 主程序版本不一致。VSCode 会在远端自动拉取 server，但拉哪个版本，由本地主程序决定——比如本地是1.90.2，远端却部署了1.102.3的 server，就会死锁。
验证方式：SSH 登录远端，执行ls -la ~/.vscode-server/bin/，看目录名是否匹配本地code --version输出的 commit hash（前几位）。
- 最简单办法：
rm -rf ~/.vscode-server，然后重连，让 VSCode 自动重装匹配版本 - 如果远端网络受限或 glibc 版本太低（如 CentOS 7），可手动下载对应 commit 的 server 压缩包，解压到
~/.vscode-server/bin/<commit-hash></commit-hash>目录下 - 内网离线环境建议提前缓存好各 VSCode 版本对应的 server 包，避免每次重连都触发下载失败
真正麻烦的是远端系统库（glibc / libstdc++）版本太旧，这时候改vscode-server版本也没用——得升级系统库，或换用静态链接版 VSCode。
