插件被 VS Code 拦截的直接验证方式是：在开发者工具控制台执行 console.log("Fitten Code active:", !!vscode.extensions.getExtension("FittenTech.Fitten-Code")?.isActive)，若输出 false，则说明因 engines.vscode 版本不匹配被静默禁用。
怎么看插件是否被 VS Code 拦截了
VS Code 1.85+ 版本会主动校验插件 package.json 中的 engines.vscode 字段，不满足就静默禁用——你找不到它、右键没反应、命令面板搜不到，不是插件坏了，是它根本没加载。最直接的验证方式是打开开发者工具控制台执行：
console.log("Fitten Code active:", !!vscode.extensions.getExtension("FittenTech.Fitten-Code")?.isActive)
若输出 Fitten Code active: false，再补一句：
vscode.extensions.getExtension("FittenTech.Fitten-Code")?.packageJSON.engines.vscode
就能看到它声明支持的版本范围，比如 "^1.103.0" 或 =1.68.0"，和你本地 code --version 输出的结果一比，立刻知道是否越界。
怎么确认 Marketplace 是否在帮你过滤旧版
Marketplace 默认只展示兼容当前 VS Code 版本的插件版本，但这个逻辑可绕过。关键看 URL 参数是否生效：
- 打开插件市场页，例如
https://marketplace.visualstudio.com/items?itemName=fitten.fitten-code - 在末尾手动加上
?vscodeVersion=1.118.0（把1.118.0替换为你本地code --version的输出） - 刷新后右下角出现
Install Another Version…下拉菜单，且有带绿色 ✅ 的选项 → 说明 Marketplace 有存档匹配版本 - 菜单灰显或无 ✅ → 作者未发布该版本的 release，必须走离线改包路径
离线安装前怎么快速验证 .vsix 兼容性
下载到 .vsix 文件后别急着双击安装，先解压检查核心字段：
- 用
unzip -l xxx.vsix | grep package.json（Linux/macOS）或 7-Zip（Windows）打开，定位到extension/package.json - 找到
"engines": { "vscode": "..." }这一行 - 对比你本地 VS Code 版本：若值是
"^1.102.0"，而你的是1.118.0，就不匹配；改成"vscode": ">=1.75.0"或精确锁死为"vscode": "=1.118.0"才能过校验 - 改完保存，重新打包为 ZIP，后缀名改回
.vsix，再通过Extensions: Install from VSIX安装
Remote-SSH 类插件要额外验证远端 server 版本
这类插件前端只是个壳，真正干活的是远端 ~/.vscode-server/bin/{commit_id}/ 下的服务进程。仅验证本地插件兼容没用，必须确认 commit ID 一致：
- 本地执行
code --version，拿到完整输出（含 40 位 commit ID，例如1.118.0 123abc...） - 远程服务器上检查
~/.vscode-server/bin/123abc.../是否存在且可执行 - 不存在？不能随便扔个
vscode-server-linux-x64.tar.gz就完事——必须确保 tar 包解压后目录名和 commit ID 完全一致 - 已存在但连接卡在
Starting VS Code Server？大概率是远端 server 二进制和本地 commit ID 不符，删掉整个~/.vscode-server目录重来
最容易漏掉的是 commit ID 这层匹配，很多人只比对 1.118.0 这种表面版本号，结果远端服务起不来还反复查 SSH 配置。
