VSCode扩展兼容性取决于本地code --version版本与插件package.json中engines.vscode字段是否匹配，不匹配则安装失败或启动后被禁用；需解压.vsix检查extension/package.json中的vscode版本要求，并确保API兼容。
VSCode 扩展是否兼容，不看市场页面写的“最新版”，只看你本地 code --version 输出的版本号和插件 package.json 里 engines.vscode 字段是否匹配。匹配不上，安装直接失败或启动后被禁用，没商量。
怎么看当前 VS Code 版本和插件要求的版本
先确认你本地到底跑的是哪个版本：
- 终端执行
code --version，第一行就是主版本号，例如1.80.2 - 打开命令面板（
Ctrl+Shift+P），输入Help: About，也能看到完整版本字符串
再拆开你要装的 .vsix 文件（它本质是 zip）：
- 把后缀改成
.zip，用系统解压工具或unzip解开 - 进
extension/package.json（注意不是根目录那个），找"engines": { "vscode": "^1.103.0" }这一行 - 对比：若你本地是
1.80.2，而插件要求^1.103.0，那它根本不会让你装
为什么“Install Another Version…”有时不可用
这个菜单项灰掉，不是你操作错了，而是插件作者根本没在 Marketplace 发布过旧版 .vsix：
- 常见于微软官方插件（如
ms-python.python）或小众维护者，他们只保留最新一两个版本 - GitHub Releases 页面可能有历史包，但不一定打包成
.vsix；有些得自己npm run package构建 - 即使找到了旧版
.vsix，也得检查它的engines.vscode是否真适配你本地版本，别只看文件名里的数字
手动改 .vsix 的 engines.vscode 要注意什么
这是内网/锁版本环境最常用的兜底手段，但改错会导致重打包后无法识别：
- 必须改
extension/package.json里的字段，不是外层那个；改错位置等于白干 - 别写死
"=1.80.0"，推荐宽松写法：">=1.80.0"或"^1.80.0"（^表示兼容 1.80.x，但不跨 minor） - Windows 下别用资源管理器双击解压再保存——会破坏 ZIP 结构；用
7-Zip、PowerShell Expand-Archive或命令行unzip -o+zip -r - 重打包后后缀必须是
.vsix，且要用Extensions: Install from VSIX命令安装，不能双击
真正容易被忽略的是：改完 engines 只解决“能不能装”，不保证“能不能用”。如果插件用了新版 API（比如 1.102+ 才有的 vscode.workspace.findFiles 新参数），就算骗过校验，运行时照样崩溃。这种时候，只能换插件，或者推动升级 VS Code 本体。
