离线安装 Git History 插件必须修改 package.json 中的 engines.vscode 字段，因其默认声明的最低 VSCode 版本（如 ^1.85.0）常高于本地版本，不修改会导致安装被拒绝、按钮灰显或提示“Unsupported”。

离线安装 Git History 插件必须改 package.json 里的 engines.vscode

VSCode 离线安装插件失败，90% 是因为下载的 .vsix 文件里声明的最低 VSCode 版本高于你本地版本。Git History（作者 donjayamanne）的 vsix 包中 package.json 的 engines.vscode 字段默认写的是类似 ^1.85.0 这样的值，而你的 VSCode 可能是 1.78.0 或更低。

不改这个字段，VSCode 会直接拒绝安装，报错信息通常不显示，只在扩展面板里灰显“Install”按钮或提示“Unsupported”。

• 把下载的 donjayamanne.githistory-X.X.X.vsix 后缀改成 .zip
• 解压，用 VSCode 打开根目录下的 package.json
• 找到 "engines": { "vscode": "^1.85.0" }，改成你本地版本兼容的范围，例如 "^1.70.0"（确认你 VSCode 版本 ≥ 1.70）
• 保存文件，再把 zip 后缀改回 .vsix
• VSCode → 命令面板（Ctrl+Shift+P）→ 输入 Extensions: Install from VSIX... → 选该文件

GitLens 离线安装后行内 blame 不显示？先检查文件是否已 git add

GitLens 的行内提交信息（每行右侧显示作者/时间/commit ID）不是靠插件“启动”就自动生效的，它严格依赖 Git 状态。未暂存、未跟踪、被 .gitignore 排除的文件，blame 区域永远是灰色虚线或空白。

GitHub一键发布助手（专业版）

本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、&quot

下载

• 终端执行 git status，确保目标文件出现在 “Changes to be committed” 或 “Modified” 列表中
• VSCode 底部状态栏必须显示分支名（如 main），否则 GitLens 认为当前不在仓库上下文中
• 右键编辑器空白处，若无 GitLens: Toggle Blame Annotations 菜单项，说明仓库未识别，不是插件问题
• 临时验证：执行 git add . && git commit -m "test"，再刷新编辑器，blame 通常立刻出现

离线环境里命令面板搜不到 Git History: View File History

插件装完但命令搜不到，不是网络问题（离线本就不需要联网），而是 VSCode 没加载成功。Git History 不提供右键菜单入口，全靠命令面板触发，搜不到等于它没活过来。

• 打开扩展面板，搜索 git history，确认 git-history（作者 donjayamanne）状态是“已启用”，不是禁用或灰色
• VSCode 1.85+ 版本中命令名可能缩写为 Git History: Show File History，试试这个全名或只输 Show File History
• 确保当前编辑器标签页已打开一个已被 Git 跟踪的文件（比如 src/index.js），不能是未保存的 Untitled-1
• 重启 VSCode —— 很多离线安装场景下，插件需重启才完成注册

git diff 对比两个 commit 时提示 fatal: bad revision 'xxx'

离线环境无法自动 fetch 远程分支，所以 Git History 里看到的 commit hash 如果来自 origin/main，但你本地没运行过 git fetch，VSCode 内置 diff 或终端 git diff 都会解析失败。

• 先在终端进仓库根目录，执行 git fetch origin（即使离线，只要远程 repo 在局域网或本地镜像，也能 fetch）
• 如果真完全断网且没提前 fetch，只能对比本地已有分支上的 commit，比如 git diff main~2 main
• 用 git log --oneline 确认两个 hash 是否都在本地 git log 输出里，不在就别硬试
• 对比大文件时，VSCode 内置 diff 易卡死，优先用 git diff --no-index 或导出 patch 后用外部工具（如 meld）

离线使用的核心矛盾在于：插件功能本身不依赖网络，但 Git 命令的上下文（分支、远程引用、commit 对象存在性）完全依赖本地仓库状态。改版本号、补 git add、手动 fetch，这些动作不是“额外步骤”，就是离线环境里让 Git 命令跑通的必要前提。