VS Code 插件“突然失效”主因是 engines.vscode 字段校验失败；需通过命令面板、开发者工具控制台或安装错误提示确认，再修改 package.json 中该字段为兼容版本并重载窗口。
绝大多数 VSCode 插件“突然失效”“灰掉”“命令找不到”，不是插件坏了，也不是网络抽风，而是 engines.vscode 字段校验失败——VS Code 在加载前就硬性拦截，不给运行机会。改对这个字段，5 分钟内就能恢复。
怎么确认是 engines.vscode 导致的禁用
别靠猜，看三处明确证据：
- 命令面板（
Ctrl+Shift+P）输入Extensions: Show Installed Extensions→ 点右上角筛选器选Disabled，插件出现在列表里且详情页顶部标着Disabled - 开发者工具（
Help → Toggle Developer Tools）→Console标签页出现红字：Extension 'xxx' is not compatible with Code '1.118.0' - 安装时弹出错误：
Unable to install extension 'xxx' as it is not compatible with VS Code '1.118.0'
离线安装 .vsix 时提示版本不兼容，必须解包改 package.json
.vsix 是 zip 包，双击或拖拽安装会直接失败，因为校验发生在解压前。必须手动干预元数据：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）解压xxx.vsix - 进入
extension/package.json（注意：不是根目录那个package.json） - 找到
"engines": { "vscode": "^1.103.0" }这一行，改为宽松范围，例如："vscode": ">=1.85.0"或"vscode": "^1.118.0"（值必须和你本地code --version输出一致或兼容） - 保存后，把整个
extension/目录重新打包为 zip，再把后缀名改回.vsix - 在 VS Code 中执行
Extensions: Install from VSIX安装改过的包
插件已安装但被禁用，直接改本地 package.json 并重载
不用卸载重装，改完立刻生效（但 VS Code 升级后该字段会被重置）：
- 关闭 VS Code
- 定位插件目录：
~/.vscode/extensions/作者名.插件名-版本号/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\作者名.插件名-版本号\（Windows） - 编辑该目录下的
package.json，修改engines.vscode值 - 启动 VS Code，执行命令面板中的
Developer: Reload Window（仅点「启用」无效）
Remote-SSH 类插件要额外处理远端 vscode-server
这类插件前端只是“遥控器”，远端 vscode-server 的二进制版本必须和本地 VS Code 主版本严格一致：
- 本地是
1.118.0，远端~/.vscode-server目录下却有1.119.0的 server，连接就会卡在Starting VS Code Server - 解决方法：远端执行
rm -rf ~/.vscode-server，然后重连，VS Code 会自动拉取匹配的 server 版本 - 注意：不能只改本地插件的
engines.vscode，远端 server 不匹配，前端改得再宽也没用
最易被忽略的是远端 vscode-server 的版本残留——它不会随本地插件更新自动清理，也不会报明确错误，只会卡在启动阶段，让人误以为是网络或权限问题。
