VSCode更新后老旧插件失效主因是package.json中"engines.vscode"版本声明不匹配，导致被自动禁用；应通过命令面板查看Disabled插件、检查控制台报错，并修改engines字段或安装兼容旧版。
VSCode 更新后老旧插件失效，基本不是“坏了”，而是被主动禁用——因为插件 package.json 里声明的 "engines": { "vscode": "^1.x" } 和你当前 VSCode 版本不匹配。强行重装或重启没用，得对症改版本声明或换兼容版。
查插件是否因版本不匹配被禁用
打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Installed Extensions，点右上角筛选器选 Disabled。如果插件出现在这里，且详情页顶部写着 Disabled，大概率就是 engines.vscode 不满足。控制台（Help → Toggle Developer Tools → Console）里常能看到类似 Extension 'ms-python.python' is not compatible with Code '1.102.3' 的红字。
- 插件卡片右上角齿轮菜单里若显示
Disable (For All Workspaces)，但你没手动点过，说明是 VSCode 自动禁用的 - 某些插件（如
esbenp.prettier-vscode）在 1.102+ 后把engines收紧到">=1.85.0 ，你用的是 1.84.2 就直接进 Disabled 列表 - 别信“已启用”状态栏图标——它可能只是 UI 残留，实际没激活。按
Ctrl+Shift+P输插件命令（比如prettier.format）看是否报command 'prettier.format' not found
手动安装旧版插件（推荐优先尝试）
扩展面板里点插件右下角 ⋯ → Install Another Version…，选一个和你当前 code --version 匹配的历史版本。这个操作比改 .vsix 安全、省事，且保留市场签名验证。
- 如果该选项灰显，说明作者没发布对应版本，或 VSCode 市场未收录——此时才需要手动下载
.vsix - 高频出问题的插件：
ms-python.python、esbenp.prettier-vscode、ms-vscode-remote.remote-ssh，它们在 1.102+ 后对引擎限制明显变严 - Remote-SSH 类插件还要注意远端
~/.vscode-server版本必须和本地主程序一致，否则连接卡在Starting VS Code Server，得先rm -rf ~/.vscode-server再重连
修改 .vsix 中的 engines 字段（离线/内网场景必需）
离线环境或市场无旧版时，必须解包改 package.json。.vsix 本质是 zip，不能双击安装，否则跳过校验直接失败。
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）打开.vsix - 找到根目录下
extension/package.json（注意不是外层的package.json） - 把
"engines": { "vscode": "^1.103.0" }改成你当前版本能接受的范围，例如"^1.85.0"或更宽松的">=1.85.0 ；避免写死 <code>=1.85.0，以防 minor 版本小更新又不认 - 保存后重新打包为 zip，再把后缀名改回
.vsix，最后用命令面板运行Extensions: Install from VSIX
插件启用后仍不工作？检查 activationEvents 和依赖
插件显示“已启用”但功能静默失效（比如 Prettier 不格式化、ESLint 不标红线），常见原因是 activationEvents 没触发，或依赖路径错乱。
- 打开插件详情页（点插件名），看
Activation Events字段：如果是onLanguage:python，那得先打开一个.py文件才能激活；空窗口或.txt文件不会触发 - 控制台里搜
Activating extension，如果看到failed但没具体错误，可能是 Node.js 版本不匹配——VSCode 内置的 Node 版本随主程序升级，老旧插件若用了require('child_process').spawn调用外部tsc或python，而路径配置（如python.defaultInterpreterPath）没同步更新，就会卡住 - 手动安装的插件若缺失
node_modules（用unzip -l xxx.vsix | grep node_modules检查），VSCode 不会自动npm install，必须找作者发布的完整构建包
最易忽略的一点：插件禁用状态会通过 Settings Sync 跨设备继承。你在公司电脑上禁用过某个插件，回家开 VSCode 同步后它也自动禁用，且毫无提示——所以排查前先确认是否开了同步，并检查另一台机器上的状态。
