git blame 逐行标注一个文件:每行是谁、在哪次提交、什么时间最后改过。排查「这行为什么这么写」「这个魔法数字谁加的」时,它比翻提交历史快得多。
本文列出 git blame 的常用参数,包括限定行范围、忽略空白与跨文件追踪代码来源。
关于本系列
本文是《Git 使用教程》按命令拆分的第 10 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用
git blame -h 看精简列表、git help blame 看完整手册。示例以 Git 2.56.0 为准。一、命令语法
先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。
bash语法
git blame [<options>] [<rev>] [--] <file>
二、参数逐项详解
下表按用途列出 git blame 的常用参数,每项都注明了「它到底改变了什么」。
| 参数 | 作用 |
|---|---|
-L <起>,<止> | 只标注指定行区间;也支持 -L /正则/ 定位到函数 |
-L <起>,+<n> | 从某行起标注 n 行,适合只看一个函数 |
-w | 忽略空白变化,避免格式化提交掩盖真正的作者 |
-C / -C -C / -C -C -C | 追踪从其它文件复制/移动过来的代码行,级别逐级加深 |
-M | 检测同一文件内部移动的行 |
--date=<格式> | 日期显示格式,如 short、iso、relative |
-n / --show-number | 显示原始行号(文件被改过之后仍有参考价值) |
-e / --show-email | 显示完整邮箱而不是用户名 |
-s | 抑制作者名与时间,只留提交哈希 |
--porcelain | 机器可读格式,供脚本与 IDE 插件解析 |
-- <file> | 分隔选项与文件路径 |
三、常用示例
定位一段可疑代码
bash定位一段可疑代码
git blame -L 20,35 src/app.js
git blame -L 20,+15 --date=short src/app.js
git blame -L "/function calcTotal/,+20" src/order.js
排除格式化干扰
bash排除格式化干扰
git blame -w -C src/utils.js
git blame --porcelain src/app.js | head -20
从 blame 结果跳到那次提交
bash从 blame 结果跳到那次提交
git blame -L 42,42 src/app.js # 拿到提交哈希 a1b2c3d
git show --stat a1b2c3d
git log -1 --format=fuller a1b2c3d
四、注意事项
blame 看的是「最后修改」不是「原创」
一次纯格式化或整体重排提交会把大量行的作者改成自己。遇到这种情况先加
-w,再用 git log --follow -- <file> 顺藤摸瓜找真正的引入提交。配套动作: 拿到哈希后立刻
git show <哈希> 看当时的完整改动与提交说明,通常就能还原当时的上下文,不用去问人。五、小结
git blame 的价值不在「追责」,而在还原上下文。参数里最实用的是 -L(缩小范围)和 -w(跳过空白改动),两者基本能覆盖日常排查。
本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git reflog 命令参数详解。