必须通过“帮助→关于”或code --version查看精确版本号（如1.94.2），fitten code要求vs code≥1.68.0，低于此版本无法加载核心服务；兼容性需严格比对package.json中engines.vscode字段。
怎么看当前 VS Code 版本号
打开 VS Code → 点击左上角【帮助】→ 【关于】，版本号就写在弹窗里，比如 1.94.2。这个数字就是判断兼容性的唯一依据，不是“差不多就行”，而是必须满足插件声明的最低要求。
如果界面看不清，或想批量验证，直接在终端执行：code --version
输出结果就是精确的主版本号（如 1.94.2），VS Code 内部比对时只取前两段（1.94）做范围匹配。
怎么查扩展到底支持哪些 VS Code 版本
别信插件卡片上模糊的“兼容”描述，真实限制写在它的 package.json 里。有三种可靠方式：
- 在扩展市场网页版搜索该插件 → 进入详情页 → 滚动到 Compatibility 区域，看
VS Code version字段，例如>=1.68.0或^1.85.0 - 已安装插件：按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 在控制台执行：vscode.extensions.getExtension("FittenTech.Fitten-Code")?.packageJSON.engines.vscode
会直接输出它声明的版本约束 - 离线 .vsix 文件：用 7-Zip / Archive Utility 解压 → 找到
extension/package.json→ 查"engines": { "vscode": "..." }这一行
为什么插件明明装上了却不工作
常见假象是“已安装”，实则被静默禁用。关键信号包括：
- 命令面板里输插件命令（如
prettier.format）报command 'prettier.format' not found - 控制台出现红字：
Extension 'ms-python.python' is not compatible with Code '1.102.3' - 扩展面板筛选器选 Disabled 后，插件出现在列表里
- 右键菜单、状态栏图标还在，但功能完全没响应——这是 UI 缓存残留，不可信
VS Code 不会提示“已禁用”，只会让它无声失效。只要 engines.vscode 不满足，插件连激活逻辑都不会跑。
离线环境怎么快速验证兼容性
内网或受限机器上，不能靠市场自动判断，得手动比对：
- 先执行
code --version得到本地版本（如1.90.2） - 下载 .vsix 文件，解压后打开
extension/package.json - 检查
"vscode": "^1.85.0"这类字段 ——^1.85.0表示兼容1.85.0到1.90.0（不含1.90.0），所以1.90.2就不满足；而>=1.85.0才真正兼容1.90.2 - ARM Mac 装了 x64 插件、Windows 上路径含空格未加引号，也会触发同类报错，需一并核对
版本兼容不是“能装上就行”，而是 engines.vscode 的语义化范围必须覆盖你本地 code --version 的实际值——差一个小版本号，插件就彻底失活，且没有任何友好提示。
