Fitten Code 插件要求 VS Code 版本不低于 1.68.0，低于此版本无法加载核心服务；1.85+ 版本因 engines.vscode 字段校验变严，旧版插件会被静默禁用。可通过 code --version 查精确版本，或在开发者工具中执行 console.log(vscode.extensions.getExtension("FittenTech.Fitten-Code")?.packageJSON.engines.vscode) 查看插件声明的兼容范围。
VS Code 不同版本的兼容性问题，核心在于 engines.vscode 字段校验是否通过——不是插件“装不上”，而是 VS Code 主进程启动时就拒绝加载；低于 1.68.0 的版本连 Fitten Code 核心服务都起不来，高于 1.85.0 则可能因校验变严被静默禁用。
怎么看当前 VS Code 版本是否满足插件要求
直接执行命令比翻菜单更可靠：
- 终端运行
code --version（确保已加入 PATH），输出如1.118.0就是精确版本号 - 打开命令面板（
Ctrl+Shift+P），输入并执行Developer: Toggle Developer Tools，在控制台粘贴：console.log(vscode.extensions.getExtension("FittenTech.Fitten-Code")?.packageJSON.engines.vscode)输出类似"^1.103.0"或=1.68.0"，这就是插件声明的兼容范围 - 若你本地是
1.118.0，而插件声明为"^1.103.0"，语义化版本规则下它是合法的；但若声明为"^1.120.0"，则必然不匹配
为什么 Marketplace 显示“不支持此版本”或按钮灰显
这不是网络或权限问题，而是 VS Code 1.85+ 启用了强制引擎校验，Marketplace 默认只展示 engines.vscode 声明覆盖当前版本的 release。
- 手动触发旧版列表：在插件市场 URL 末尾加参数，例如
https://marketplace.visualstudio.com/items?itemName=FittenTech.Fitten-Code?vscodeVersion=1.118.0 - 刷新后右下角出现
Install Another Version…下拉菜单，**只选带绿色 ✅ 的条目**——没勾的版本未被 Marketplace 显式验证过，安装后大概率失败 - 若整个菜单灰显，说明作者未发布任何与你版本匹配的历史 release，必须走离线修改路径
如何安全修改 .vsix 中的 engines.vscode 字段
别双击解压、别用资源管理器拖拽保存——ZIP 结构损坏会导致安装时报 invalid vsix。
- 用
unzip（Linux/macOS）或7-Zip（Windows）解压fitten-code-*.vsix - 编辑
extension/package.json（注意不是根目录那个），找到"engines": { "vscode": "^1.103.0" } - 改成宽松范围，例如：
"vscode": ">=1.75.0"（推荐，覆盖多数维护中版本）
或精确锁定："vscode": "=1.118.0"（适合锁死环境） - 重新打包为 ZIP，再把后缀名改回
.vsix；在 VS Code 中执行Extensions: Install from VSIX
插件已安装但被禁用，改完 engines 还要重载窗口
VS Code 对已安装插件的 engines.vscode 字段仍会校验，改完本地 package.json 后不能只点「启用」。
- 定位插件目录：
Windows：%USERPROFILE%\.vscode\extensions\FittenTech.Fitten-Code-*
macOS/Linux：~/.vscode/extensions/FittenTech.Fitten-Code-* - 编辑该目录下的
package.json，同步修改engines.vscode字段值 - 必须执行命令面板中的
Developer: Reload Window，否则修改不生效 - 注意：VS Code 升级后，这个字段会被自动还原为原始值，需重复修改
最容易被忽略的是 Remote-SSH 类插件——它前端和远端 vscode-server 的二进制版本必须严格一致，降级 VS Code 后不清理远端 ~/.vscode-server 目录，连接就会卡在 Starting VS Code Server。
