插件被版本不兼容禁用可先查是否在Disabled列表：打开命令面板输入Extensions: Show Installed Extensions，筛选Disabled；若插件详情页显示Disabled或“requires newer VSCode”，并配合控制台红字报错“not compatible with Code 'x.x'”，即确认为engines.vscode不匹配。
怎么看插件是不是被版本不兼容禁用了
插件没反应、命令报 command 'xxx' not found、状态栏图标灰掉但没手动禁用——这些八成是被 VSCode 主动禁用了。打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Installed Extensions，点右上角筛选器选 Disabled。如果目标插件出现在这里，且详情页顶部写着 Disabled 或提示 requires a newer version of VSCode，基本就是 engines.vscode 不匹配。
顺手打开开发者工具（Ctrl+Shift+I → Console），搜红字：Extension 'FittenTech.Fitten-Code' is not compatible with Code '1.102.3' 这类报错直接坐实问题。
怎么查当前 VSCode 版本和插件声明的兼容范围
终端执行 code --version 拿到本地版本号（比如 1.102.3）。再进插件市场网页版，搜插件名，滚动到 Compatibility 区域，看它写的 VS Code version 范围，例如 >=1.85.0 。两者一对比，立刻知道是否越界。
更直接的方法：在已安装插件页面，点插件右下角 ⋯ → Copy Extension ID，然后命令面板运行：
console.log(vscode.extensions.getExtension("FittenTech.Fitten-Code")?.packageJSON.engines.vscode)
输出类似 "^1.68.0" 或 >=1.68.0，就是它硬性要求的最低版本。
装旧版插件比改 .vsix 更安全、更快
扩展面板里点插件右下角 ⋯ → Install Another Version…，选一个和你 code --version 匹配的历史版本。这个操作保留签名验证，不会破坏市场信任链。
- 高频出问题的插件：
ms-python.python、esbenp.prettier-vscode、ms-vscode-remote.remote-ssh - 如果该选项灰显，说明作者没发布对应版本，才需要下载 .vsix 手动解包改
extension/package.json里的engines.vscode - 改的时候别写死
"=1.85.0"，用">=1.85.0"或"^1.85.0"更稳妥
Remote-SSH 类插件要同步远端 server 版本
这类插件不是纯前端，会在远端自动拉取 vscode-server。本地是 1.102.3，远端却跑着 1.103.0 的 server，就会卡在 Starting VS Code Server 或报 Failed to fetch commit hash。
修复方法很简单：
- 先在远端执行
rm -rf ~/.vscode-server - 再重连，VSCode 会自动下载匹配本地版本的 server
- 注意：远端
~/.vscode-server目录权限必须属于当前用户，否则拉取失败
真正麻烦的是多环境混合场景——比如本地 VSCode 是 1.102.3，但某台服务器只允许离线部署，且它的 glibc 版本太老，连 1.102.0 的 server 都起不来。这种时候，光改 engines 字段没用，得回退整个 VSCode 主程序版本。
