VS Code更新后插件失效等问题主因是engines.vscode版本不匹配，需查code --version确认本地版本，通过解压.vsix修改extension/package.json中engines字段为“>=当前版本”，重打包安装并彻底重启。
VS Code 更新后插件失效、命令找不到、Remote-SSH 卡在启动、中文包不生效——这些问题九成不是插件坏了，而是 engines.vscode 字段声明和当前版本对不上。VS Code 启动时会硬校验这个字段，不满足就直接禁用，连日志都懒得写。
怎么看当前 VS Code 版本是否被插件认可
别猜，直接查准的：
- 终端执行
code --version，第一行就是主版本号，比如1.90.2 - 打开命令面板（
Ctrl+Shift+P），输入Developer: Show Running Extensions，看已启用/禁用列表里有没有插件标着 “Disabled” 或 “not compatible” - 如果插件卡片右上角齿轮菜单显示
Disable (For All Workspaces)，但你没点过，基本就是被自动禁用了 - 控制台（
Help → Toggle Developer Tools → Console）里搜红字：Extension 'xxx' is not compatible with Code '1.xxx.x'
怎么确认插件 package.json 里的 engines.vscode 要求多少
.vsix 文件本质是 zip，必须解包才能看到真实声明：
- 把
xxx.vsix后缀改成.zip，用系统自带解压工具或unzip解开 - 进到
extension/package.json（注意不是根目录那个package.json） - 找
"engines": { "vscode": "^1.103.0" }这一行 —— 这个值才是 VS Code 安装时真正比对的依据 - 语义化版本规则要清楚：
^1.103.0表示 ≥1.103.0 且 <2.0.0；>=1.85.0才能向下兼容旧版
离线或内网环境怎么改 .vsix 让它适配旧版 VS Code
不能双击安装，也不能靠市场自动降级——得手动改包：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）打开 .vsix - 定位并编辑
extension/package.json中的engines.vscode值，例如从"^1.103.0"改成">=1.85.0"（推荐宽松写法，避免 minor 小更新又卡住） - 保存后，把整个文件夹重新打包为 zip，再把后缀名改回
.vsix - 命令面板运行
Extensions: Install from VSIX，选这个改过的文件 - 改完必须完全退出 VS Code（包括托盘进程），否则缓存可能让修改不生效
Remote-SSH / WSL 连不上？别只盯本地插件
Remote 扩展会在远端机器部署 vscode-server，这个二进制版本必须和本地 code --version 严格一致：
- 远端路径通常是
~/.vscode-server，删掉它再重连，VS Code 会自动拉取匹配版本 - 如果远端是受限环境（如容器、无外网服务器），需手动下载对应 commit 的 server 包，放到远端正确路径
-
vscode-server的版本号藏在本地插件目录的package.json里：~/.vscode/extensions/ms-vscode-remote.remote-ssh-*.vsix解包后查engines.vscode和serverVersion字段 - 远端
glibc版本太低也会导致 server 启动失败，此时需换用更老的 VS Code 主程序版本
最常被忽略的是：改完 engines.vscode 后没清 Cache，或者没杀干净后台 Code.exe 进程，导致 VS Code 加载的还是旧缓存。重启前务必确认所有相关进程已退出。
