根本不是“装不上”，而是 engines.vscode 字段校验直接拦截，必须改版本声明或换匹配版本；插件提示“requires a newer version of VSCode”时应选兼容旧版的插件历史版本或手动修改.vsix中package.json的engines字段为"vscode": ">=1.85.0"并重打包安装。
VSCode 版本过低导致插件无法启用、Remote-SSH 连接失败、中文包报 not compatible 错误——根本不是“装不上”，而是 engines.vscode 字段校验直接拦截，必须改版本声明或换匹配版本，不能靠重装/重启解决。
插件提示“requires a newer version of VSCode”怎么办
这是最典型的兼容性红灯，VSCode 启动时读取插件 package.json 中的 "engines": {"vscode": "^1.98.0"}，发现本地 code --version 是 1.85.2，立刻禁用，不报错也不加载。
- 打开扩展面板，点击插件右下角 ⋯ → Install Another Version…，选一个明确支持你当前版本的历史版（如
prettier-vscode的 v9.13.0 支持 1.85+） - 若该选项灰显，说明插件作者未发布旧版 → 去 GitHub Releases 找对应
.vsix文件，或从旧机器复制 - 手动安装后仍不生效？检查插件目录下
package.json是否含已废弃 API 调用（如workspace.findFiles的useGitIgnore选项在 1.90+ 移除），这类问题只能等作者修复
离线安装 .vsix 提示“version not compatible”
离线场景下，VSCode 对 .vsix 的引擎校验更严格，双击安装会直接失败，必须手动修改元数据。
- 用
7-Zip（Windows）或unzip（Linux/macOS）解压.vsix文件（它本质是 ZIP） - 进入
extension/package.json，找到"engines": {"vscode": "^1.103.0"}，改为宽泛范围，例如："vscode": ">=1.85.0"（推荐）或"vscode": "^1.85.0 || ^1.90.0" - 保存后重新打包为 ZIP，后缀名改回
.vsix；用命令面板运行Extensions: Install from VSIX安装 - 注意：别用 Windows 资源管理器直接解压再保存，会破坏 ZIP 结构导致安装失败
VSCode 自身版本太低，但又不能升到最新版
比如你要连 CentOS7 远程服务器，新版 VSCode Server 要求 glibc ≥ 2.28，而 CentOS7 只有 2.17，强行升级 VSCode 会导致 Remote-SSH 直接卡死在 “Starting VS Code Server”。这时降级比升级更合理。
- 访问
https://code.visualstudio.com/sha/download?build=stable&os=win32-x64（Windows）、&os=darwin-universal（macOS）、&os=linux-x64（Linux），滚动页面找 1.85.2 或 1.90.3 这类已验证兼容旧系统的稳定版 - 下载后直接安装（Windows/macOS）或
sudo apt install ./code_1.85.2-1731761512_amd64.deb（Linux），无需卸载旧版，不同版本默认隔离 - 安装完立即打开设置，搜
update.mode，设为none；再进开发者工具控制台执行vscode.version确认输出是你装的版本
中文包加载失败、界面仍是英文
不是插件没装，是 locale.json 没配或配错，VSCode 根本不读语言包。
- 确认插件已启用且
package.json中engines.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，写错就无效） - 改完必须完全退出 VSCode（包括右下角托盘进程），再启动；若仍无效，检查日志里是否有
Failed to load language pack，说明资源文件损坏，需重下 .vsix
所有操作里最容易被忽略的是：改完 package.json 或 locale.json 后没彻底退出 VSCode，残留进程仍在读旧缓存；还有就是 Linux 下用 apt install code 升级时漏掉 --only-upgrade，导致版本卡死不动。
