90%插件禁用源于engines.vscode字段不匹配：需查插件extension/package.json中"vscode"值，对比code --version输出，不满足则静默禁用；Disabled列表、控制台not compatible报错或console.log(!!vscode.extensions.getExtension(...)?.isActive)为false可确认。
插件版本兼容性问题，90% 是 engines.vscode 字段不匹配导致的静默禁用，不是插件坏了，也不是网络或权限问题——直接查这个字段最准。
怎么看插件当前声明的 VS Code 版本要求
每个插件在安装后都会解压到本地扩展目录，关键信息藏在它的 package.json 里。你不需要打开市场页面猜，也不用依赖 UI 提示（有时根本不显示）：
- 找到插件目录：Windows 是
%USERPROFILE%\.vscode\extensions\{publisher}.{name}-x.x.x，macOS/Linux 是~/.vscode/extensions/{publisher}.{name}-x.x.x - 打开里面的
extension/package.json（注意是extension/子目录下的，不是根目录那个） - 搜索
"engines"，重点关注"vscode": "..."的值，比如">=1.85.0"或"^1.103.0"
这个值就是插件“自己说的”最低支持版本。如果 code --version 输出的是 1.84.2，而插件写的是 ^1.85.0，那它一定不会加载——VS Code 启动时就跳过，连错误日志都可能不打。
怎么快速确认插件是否被版本不兼容禁用
别靠右键菜单有没有命令、状态栏有没有图标来判断，那些可能是缓存残留。真实状态得看 VS Code 内部的激活逻辑：
- 打开命令面板（
Ctrl+Shift+P），输入Extensions: Show Installed Extensions，点右上角筛选器选Disabled - 如果插件出现在这里，且详情页顶部明确标着
Disabled，基本就是engines.vscode不满足 - 打开开发者工具（
Help → Toggle Developer Tools），切到 Console 标签页，搜not compatible，典型报错如：Extension 'ms-python.python' is not compatible with Code '1.102.3' - 在命令面板运行：
Developer: Toggle Developer Tools→ 控制台执行：console.log(!!vscode.extensions.getExtension("ms-python.python")?.isActive)，输出false就说明没激活
离线或内网环境怎么改 .vsix 让它兼容旧版 VS Code
有些插件没发历史版本，或者你根本没法联网进市场，就得手动改 .vsix。它本质就是个 ZIP 包，改法固定：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）打开.vsix文件，不要双击资源管理器解压 - 进入
extension/package.json，修改"engines": { "vscode": "..." }，推荐写成宽松范围，例如：">=1.85.0"（别写死"=1.85.0"，小版本更新会再次失败） - 保存后，把整个文件夹重新打包为 ZIP，再把后缀名从
.zip改回.vsix - VS Code 关闭状态下，用命令面板运行
Extensions: Install from VSIX安装这个改过的文件
改完必须完全退出 VS Code（包括托盘进程），否则 locale、插件状态等缓存仍可能让修改不生效。
为什么装了旧版还会自动变成新版
VS Code 默认每小时检查更新，而且有些插件默认走预发布通道（pre-release），它的版本号（如 10.0.0-pre.1）语义上比稳定版（如 9.10.3）还高，结果你手动装的旧版反被自动覆盖：
- 设置中搜
extensions.autoUpdate，设为false - 打开插件详情页，点右上角
⋯，确认没勾选Switch to Pre-release Version - 装完后立刻检查插件根目录
package.json的version字段，确保真写的是你要的旧版，避免缓存混淆
真正容易被忽略的是：远程开发（如 Remote-SSH）场景下，远端 ~/.vscode-server 的版本也必须和本地 VS Code 主程序严格一致，否则连接卡在 Starting VS Code Server——这和插件无关，但常被误判为兼容性问题。
