VS Code插件兼容性取决于package.json中"engines.vscode"声明与code --version输出版本的语义化匹配，不匹配则插件被静默禁用；需检查已安装插件的package.json、使用URL参数查看历史版本、并确保Remote-SSH等插件远端vscode-server版本严格一致。
VS Code 旧版本兼容性问题，核心就一条：插件 package.json 里写的 "engines.vscode" 声明值，必须和你本地 code --version 输出的版本号满足语义化匹配规则。不满足，插件就会被静默禁用或根本装不上——不是网络问题，也不是插件坏了。
怎么看当前 VS Code 版本是否满足插件最低要求
打开终端，执行：
code --version
输出类似 1.118.0 这样的数字。然后去查插件的 engines.vscode 字段值，常见形式有：
-
"^1.68.0"→ 表示支持1.68.0到1.68.x（不含1.69.0） -
">=1.75.0"→ 表示支持所有 ≥1.75.0的版本 -
"=1.85.2"→ 表示只认这个精确版本
若你本地是 1.118.0，而插件写的是 "^1.103.0"，那它能用；但若写的是 "^1.119.0"，那就直接被拦住。
插件已安装却“消失”？先确认是否被自动禁用
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行：
Extensions: Show Installed Extensions
点右上角筛选器，选 Disabled。如果插件出现在这里，且详情页顶部明确标着 Disabled，基本就是 engines.vscode 不匹配导致的自动禁用。
- 别点“启用”按钮——VS Code 会立刻再把它禁掉
- 控制台（
Help → Toggle Developer Tools → Console）里常能看到红字：Extension 'FittenTech.Fitten-Code' is not compatible with Code '1.118.0' - 右键菜单没反应、命令面板搜不到命令、状态栏图标不显示，都是典型表现
怎么查已安装插件实际声明的兼容版本
找到插件本地目录：
- Windows：
%USERPROFILE%\.vscode\extensions\FittenTech.Fitten-Code-* - macOS：
~/Library/Application Support/Code/User/extensions/FittenTech.Fitten-Code-* - Linux：
~/.vscode/extensions/FittenTech.Fitten-Code-*
进入该目录，打开 package.json，搜索 "engines" 字段，看里面的 "vscode" 值。这才是 VS Code 真正校验的依据，不是 Marketplace 页面上写的“支持版本”。
注意：这个文件里的 version 字段（比如 "1.2.3"）只是插件自身版本号，和兼容性无关。
Marketplace 页面不显示旧版？用 URL 参数强制触发
VS Code 1.85+ 默认隐藏历史版本，但市场页支持手动传参激活：
- 打开插件市场页，例如：
https://marketplace.visualstudio.com/items?itemName=FittenTech.Fitten-Code - 在 URL 末尾追加：
?vscodeVersion=1.118.0（把1.118.0换成你本地真实版本） - 刷新页面，右下角会出现 Install Another Version… 下拉菜单
- 只选带绿色勾号 ✅ 的版本——这是 Marketplace 显式验证过的兼容版本
如果菜单灰显，说明作者没发布任何匹配你版本的历史 release，这时就得走离线改 .vsix 的路子。
最易被忽略的一点：Remote-SSH、WSL 这类插件，不仅前端要兼容，远端自动部署的 vscode-server 二进制也必须和本地主版本严格一致。哪怕只差一个 patch 号（比如本地 1.118.0，远端拉了 1.118.1 的 server），连接就会卡在 Starting VS Code Server。
