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 命令参数详解。