sublime text 需装 git history 插件并正确配置 git 环境才能查看文件历史；常见问题包括未在 git 仓库内打开文件、git 未加入 path、插件被禁用或 git_binary 路径未指定；行级追溯需用 git blame，推荐 gitgutter 或 sublimegit；历史不更新可能因未刷新状态或 amend/rebase 导致缓存失效。
Sublime Text 本身不带 Git 历史查看功能，必须依赖插件或外部命令集成；直接打开文件右键点“Git History”却没反应，90% 是 Git 环境或插件配置没到位。
Git History 插件装了但命令不出现
常见错误现象：安装完 Git History 后，右键菜单没有 Git History: View File History，命令面板也搜不到该命令。
- 确认当前文件在 Git 仓库内——检查目录下是否存在
.git文件夹；Sublime 必须以项目根目录（或其子目录）方式打开文件，不能只用“File → Open File…”单独打开一个源文件 - 确保系统级 Git 可执行：终端运行
git --version能正常输出；Windows 用户尤其注意是否把 Git 的bin或cmd目录加进了PATH环境变量 - 插件可能被禁用：打开
Preferences → Package Settings → Git History → Settings，检查"enabled": true是否生效；也可在Package Control: Disable Package列表里确认它没被误关
想看某一行是谁改的？别只用 View File History
Git History: View File History 展示的是整个文件的提交列表，但实际调试时更常需要知道“这一行代码哪次提交加的”，这时候得用 git blame 行级定位。
- 推荐插件：
GitGutter（轻量，侧边栏显示修改状态）或SublimeGit（功能全，支持git blame、git log -p等） - 快捷键绑定示例（用户键位设置中添加）：
{"keys": ["ctrl+alt+b"], "command": "git_blame"}—— 按下后光标所在行会弹出作者、时间、commit hash - 如果插件报错
Unable to find git binary，不是路径写错，而是 Sublime 没读取到系统环境变量；可在插件设置里显式指定："git_binary": "/usr/bin/git"（macOS/Linux）或"git_binary": "C:\Program Files\Git\bin\git.exe"（Windows）
自定义 build system 调用 git blame 的坑
有人用 Tools → Build System → New Build System… 写 JSON 调 git blame，结果只显示空白或报错 fatal: no such path。
-
"working_dir": "$file_path"必须存在且是 Git 工作区根目录；若$file_path指向子模块或符号链接路径，git可能无法识别仓库边界 -
"cmd"中的$line变量仅在构建系统被“行上下文触发”时有效（比如按Ctrl+Shift+B且光标在某行），普通Ctrl+B不带上下文，$line为空，导致命令变成git blame -L , ...报错 - 安全写法：用
variants分离两种行为，主命令留空或设为文件级 blame，变体再做行级；避免把$line直接塞进默认cmd
历史记录里看不到刚 commit 的内容？
刚执行完 git commit，立刻在 Sublime 里打开 Git History: View File History，却发现最新提交没列出来。
- 不是插件缓存问题，而是 Sublime 插件通常不自动
git fetch或git update-index；本地 commit 会被识别，但远程新提交需手动刷新 - 解决办法：在命令面板运行
Git: Refresh Status（SublimeGit提供）或关闭再重开文件；部分插件如GitGutter会在保存文件后自动重载状态，但不触发历史列表更新 - 真正容易被忽略的一点：如果你用的是
git commit --amend或交互式 rebase 修改了历史，旧 commit hash 已失效，插件缓存的哈希可能指向不存在的节点，此时需清空插件临时缓存（路径通常在Packages/User/GitHistory/Cache/）
