VS Code主动禁用Git插件可通过Extensions: Show Disabled Extensions命令确认，若插件列表中显示“Disabled”且控制台报“not compatible with Code 'x.x.x'”，即因engines.vscode版本不匹配被自动禁用。
怎么确认 Git 插件是被 VS Code 主动禁用的
VS Code 更新后，GitLens、Git Graph、Git History 这类插件突然不响应命令（比如 gitlens.showQuickMenu 报 command 'gitlens.showQuickMenu' not found），但状态栏 Git 图标还在——这大概率不是插件崩溃，而是被自动禁用。打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Disabled Extensions，如果插件出现在列表里，且详情页顶部明确写着 Disabled，就基本锁定是 engines.vscode 版本不匹配。
控制台（Help → Toggle Developer Tools → Console）里常有红字：Extension 'eamodio.gitlens' is not compatible with Code '1.102.3'。注意：别信右下角齿轮菜单显示的 Disable (For All Workspaces) ——如果你没手动点过，那就是 VS Code 自己干的。
GitLens 等插件提示“Unable to install”时怎么绕过 marketplace 校验
在扩展市场里点安装，直接弹出 Unable to install because it depends on vscode@^1.103.0，说明校验卡在下载前，连 .vsix 都没进到本地。这时必须跳过 marketplace：
- 去插件 GitHub Releases 页面（比如
https://github.com/eamodio/vscode-gitlens/releases）找一个和你本地code --version匹配的旧版.vsix文件（如gitlens-14.15.0.vsix） - 在 VS Code 中执行
Extensions: Install from VSIX，选中该文件安装 -
不能双击安装：系统会跳过引擎检查但触发签名校验失败；必须用命令面板或
code --install-extension xxx.vsix命令行方式
安装后若仍不加载，打开开发者工具 Console，过滤 gitlens，看是否有 failed to activate 报错——那可能是 API 兼容性断裂，比如调用了已移除的 workspace.findFiles 选项。
手动修改 .vsix 里的 engines 字段要注意什么
.vsix 是 zip 包，但修改有硬性顺序，错一步就白忙：
适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……
- 先关闭所有 VS Code 窗口（包括后台进程）
- 用
7-Zip（Windows）、unzip（Linux/macOS）解压.vsix，不要用系统自带归档工具（可能损坏结构） - 找到
extension/package.json（不是根目录那个！），改"engines": { "vscode": "^1.103.0" }为"vscode": ">=1.85.0 或更宽松的 <code>"^1.78.0 || ^1.85.0"；避免写死"=1.85.0"，否则 minor 小更新又挂 - 保存后重新打包为 zip，再把后缀名改回
.vsix；用zip -r gitlens-fix.vsix extension/（Linux/macOS）确保目录结构正确 - 最后用
Extensions: Install from VSIX安装，别拖拽
改完仍不生效？可能是 VS Code 缓存了旧元数据。删掉 ~/.vscode/extensions/eamodio.gitlens-* 目录，再重装；或者执行 Developer: Reload Window 后观察 Console 是否还有激活失败日志。
Remote 开发场景下 Git 插件失效的隐藏原因
你在本地用 GitLens 看提交历史很顺，但一连 Remote-SSH，GitLens 的右键菜单就消失、gitlens.openFileInRemoteRepository 命令报错——这往往不是 GitLens 本身问题，而是远端 ~/.vscode-server 版本和本地不一致。VS Code 1.102.x 要求远端也运行同版本 server，否则插件无法注入远端环境。
解决方法很直接：
- 先断开 Remote 连接
- 在远端终端执行：
rm -rf ~/.vscode-server - 重新连接，VS Code 会自动下载并安装匹配的 server 版本
- 如果远端无法联网，得手动把本地
.vscode-server对应版本的 tarball 传过去再解压
这个点容易被忽略：你本地插件一切正常，远端却加载失败，根本原因不在插件包，而在 client/server 协议层的版本握手失败。
