离线安装 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的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
- 终端执行
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 <file1><file2></file2></file1>或导出 patch 后用外部工具（如 meld）
git add、手动 fetch，这些动作不是“额外步骤”，就是离线环境里让 Git 命令跑通的必要前提。 
