为什么要忽略格式化提交
全仓统一格式化会制造一个巨大的提交，此后每一行的责任人都变成了「做格式化的那个人」，行级追溯几乎失效。忽略清单机制让行级追溯跳过指定的提交，穿透格式噪音，看到真正改过这行的人。做法是把这类提交的哈希写进一个清单文件，再让 Git 读取它。
基本信息
| 配置键 | blame.ignoreRevsFile |
|---|---|
| 文件格式 | 每行一个提交哈希，可用注释行说明 |
| 命令行参数 | --ignore-rev <哈希> 或 --ignore-revs-file <文件> |
| 平台支持 | GitHub 会识别仓库内同用途的清单文件 |
| 影响范围 | 只改变本地的行级追溯结果 |
典型使用场景
- 全仓统一格式化（更换格式化工具、统一缩进）之后恢复行级追溯的可读性
- 大范围重命名目录或文件之后，掩盖纯搬移造成的大改动
- 团队迁移代码风格时，避免责任信息被一次批量提交冲掉
- 排查某行历史时临时跳过某个已知的噪音提交
- 把清单纳入仓库，让所有协作成员看到一致的行级历史
常用示例
常用示例
git config blame.ignoreRevsFile .git-blame-ignore-revs # 配置清单文件路径
git blame src/app.py # 之后自动跳过清单内的提交
git blame --ignore-rev 8f3a1c9e2b7d4f6a0c1e2d3b4a5f6c7d8e9a0b1c src/app.py # 单次跳过
git blame --ignore-revs-file .git-blame-ignore-revs src/app.py # 单次显式指定清单
git log --oneline -1 8f3a1c9e2b7d4f6a0c1e2d3b4a5f6c7d8e9a0b1c # 核对哈希对应哪次提交配置与参数
| 项 | 作用 | 生效方式 |
|---|---|---|
| blame.ignoreRevsFile | 指定默认清单文件 | 配置后长期生效 |
| --ignore-rev | 跳过单个提交 | 仅本次命令 |
| --ignore-revs-file | 临时指定清单文件 | 仅本次命令 |
清单文件本身要提交到仓库，否则只有本机看到效果；配置项属于个人设置，可以通过团队文档或统一脚本分发，两者需要配合。
只把纯粹格式化的提交放进清单。功能性改动一旦被跳过，行级追溯会指向错误的作者，排查问题时反而得出错误结论。