git blame 是什么
git blame 逐行显示文件的每一行最后一次被哪个提交、由谁改动过，输出里带着提交哈希、作者与时间。它回答的是「这行代码是谁在什么时候写的、属于哪次改动」，是排查可疑逻辑与理解历史背景的常用手段。
行归属不等于逻辑作者
blame 显示的是「行内容最后一次变更」的提交，未必是真正设计这段逻辑的人：整体缩进、格式化、重命名都可能让一大批行被算到某次表面改动头上。所以看到归属之后，应该接着看那次提交的完整内容，再判断责任与背景。
基本信息
| 适用平台 | Linux / macOS / Windows（Git 2.x） |
|---|---|
| 语法 | git blame [选项] [<提交>] [--] <文件> |
| -L | 限定行号范围或函数范围 |
| -C -C | 探测从其他文件复制或移动来的内容 |
| -w | 忽略空白改动对归属的影响 |
| ignore-revs | 配合配置忽略纯格式化提交 |
典型使用场景
- 追查可疑逻辑：定位某行是谁在哪次改动里引入的
- 理解背景：拿到提交哈希后接 git show 看完整上下文
- 排查来源：用 -C -C 探测内容是否从别的文件复制而来
- 缩小范围：用 -L 只看关键函数或行区间
- 绕过噪声：用 -w 或 ignore-revs 让纯格式化提交不影响归属
常用示例
常用示例
git blame src/app.py # 逐行显示归属
git blame -L 20,40 src/app.py # 只看第 20 到 40 行
git blame -L :func_name src/app.py # 只看某个函数
git blame -C -C src/app.py # 探测跨文件复制来源
git blame -w src/app.py # 忽略空白改动
git blame --show-email src/app.py # 显示作者邮箱输出字段读法
| 字段 | 含义 | 用途 |
|---|---|---|
| 短哈希 | 最后一次改动该行的提交 | 接 git show 看完整内容 |
| 作者与时间 | 改动者与其提交时间 | 判断责任与先后顺序 |
| 行号 | 原始行号与最终行号 | 确认改动的上下文 |
| 行内容 | 该行的当前内容 | 定位具体逻辑 |
| 尖号前缀 | 该行来自初始提交 | 仓库最初的版本内容 |
blame 输出里的提交哈希可以直接接 git show 查看完整背景与关联讨论，比只看作者名信息量大得多。
格式化类提交会污染行归属。可以用 -w 忽略空白改动，或配置 blame.ignoreRevsFile 把纯格式化提交列入忽略清单。