VSCode插件因engines.vscode版本不匹配被静默禁用，表现为插件变灰、命令报错；可通过“Extensions: Show Installed Extensions”筛选Disabled确认，控制台可见兼容性错误，需修改extension/package.json中engines.vscode字段并重装.vsix。
VSCode插件更新后报错，绝大多数不是代码出错，而是 engines.vscode 字段校验失败导致的静默禁用——它不弹窗、不提示、只让插件变灰，命令执行时报 command 'xxx' not found。
怎么确认是 engines.vscode 不匹配被禁用
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并执行 Extensions: Show Installed Extensions；点击右上角筛选器，选 Disabled；如果目标插件出现在列表里，且详情页顶部明确标着 Disabled，基本就是这个原因。
控制台（Help → Toggle Developer Tools → Console）里常出现类似错误：
Extension 'ms-python.python' is not compatible with Code '1.118.0'
插件卡片右上角齿轮菜单若显示 Disable (For All Workspaces)，但你没手动点过，说明是 VSCode 自动禁用的。
别信状态栏图标——它可能只是 UI 残留；直接在命令面板里搜插件命令（比如 prettier.format）看是否报错更可靠。
Install Another Version… 选项灰显怎么办
该选项灰显，说明插件作者没发布与你当前 code --version 匹配的历史版本。此时不能靠 Marketplace 解决，必须离线处理：
- 去插件 GitHub Releases 页面下载对应
.vsix文件（如fitten-code-1.2.3.vsix） - 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）解压该文件 - 编辑
extension/package.json（注意不是根目录那个），找到"engines": { "vscode": "^1.103.0" } - 改成宽松范围，例如：
"vscode": ">=1.75.0"或精确锁定："vscode": "=1.118.0" - 保存后重新打包为 ZIP，再把后缀名改回
.vsix - 在 VSCode 中执行
Extensions: Install from VSIX安装
注意：.vsix 是 zip 格式，双击安装会跳过校验直接失败，必须走命令面板或 code --install-extension。
Remote-SSH / WSL 连接卡在 Starting VS Code Server
这不是插件本身问题，而是远端 ~/.vscode-server 版本和本地 VSCode 主程序不一致。VSCode 1.118 要求远端 server 必须也是 1.118，否则连接会卡住或报 Failed to fetch commit hash。
修复方式很直接：
- 先在本地终端运行
code --version确认版本（比如1.118.0） - 登录远端机器，执行
rm -rf ~/.vscode-server - 重新触发 Remote-SSH 连接，VSCode 会自动拉取匹配版本的 server
如果仍失败，检查远端是否用了代理或镜像源——server 下载过程不走 VSCode 设置里的代理，需单独配置 http_proxy 环境变量。
改完 package.json 还不生效？可能是缓存或 API 断层
改完 engines.vscode 后重启仍不启用，常见原因有两个：
- VSCode 没完全退出：Windows/macOS 托盘里还有进程，Linux 可能残留
code进程，必须杀干净再启 - 插件实际调用了已废弃的 API：比如在 1.118 中被移除的
workspace.findFiles某些选项，启动时会报TypeError: xxx is not a function，这类问题只能等作者更新或换插件
最易被忽略的是：改完不重启、或改了根目录的 package.json 却没改 extension/package.json —— 后者才是 VSCode 加载时真正读取的位置。
