git diff --stat 是最轻量、信息密度高的文件级增删行统计方式,输出如“file.py | 12 +-”,仅显示改动文件、每文件行数变动及汇总,不展开代码、不解析语义,适合快速评估PR或版本影响范围。

直接用 git diff 生成的原始输出不是“详细报告”,它只是行级变更快照;真要统计增删改、按文件归类、支持导出和复用,得靠组合命令或外部工具,比如 cloc 或带 --stat/--numstat 的 git diff。
用 git diff --stat 快速看修改分布
这是最轻量但信息密度高的方式,适合日常确认“改了哪些文件、改得多不多”:
-
--stat只显示文件名、增删行数、可视化条形图(如main.cpp | 12 +-),不展开具体代码 - 加
-w忽略空格变化,避免噪音干扰:git diff HEAD~3 HEAD --stat -w - 加路径限制只统计某目录:
git diff main develop --stat src/ - 注意:它统计的是“暂存区 vs 提交”或“提交 vs 提交”,不包含未
git add的工作区改动
用 git diff --numstat 导出结构化数据
--numstat 输出制表符分隔的三列:added deleted filename,方便后续用脚本处理:
在提交旁边记录AI编码会话,以便代理程序可以恢复代码更改的原因、从检查点恢复以及干净地交接工作。
- 直接重定向保存:
git diff main develop --numstat > diff_stats.tsv - 可管道进
awk算总量:git diff HEAD~5 HEAD --numstat | awk '{add += $1; del += $2} END {print "add:", add, "del:", del}' - 文件名含空格时需加
--no-renames防止被误切;重命名检测开启时,--numstat会把重命名记为 0 增删,但保留旧/新路径 - 它不统计二进制文件(如图片、编译产物),返回空行或跳过
用 cloc 做语言级代码量对比
当你要知道“Vue 文件比上次多了 200 行逻辑,Python 少了 50 行”,git diff 不够用,得靠 cloc:
- 先导出两个版本的快照:
git archive main | cloc --stdin-name=main.tar -和git archive develop | cloc --stdin-name=develop.tar - - 再用
cloc --diff对比:cloc --diff main.tar develop.tar,输出每种语言的净增删行、文件数变化 - 支持 CSV/JSON 导出:
cloc --diff --csv --out=diff_report.csv main.tar develop.tar - 坑点:如果仓库里有大文件(如数据集),
git archive会卡住,建议先git config tar.tar.xz.command "xz -c"启用压缩
为什么不用 GUI 工具直接截图?
截图或 VS Code 内置 Diff 视图解决不了“报告”需求:
- 无法批量提取数字指标(比如“本次 PR 总共新增 1273 行业务代码”)
- 不能自动归档到 CI 流程中做质量门禁(例如:新增测试覆盖率低于 80% 则阻断合并)
- 历史对比难回溯——你没法用截图证明“上周五的
utils.js修改量是现在的 3 倍” - 真正需要报告的场景(Code Review 汇报、Sprint 总结、合规审计),本质是结构化数据,不是视觉快照
复杂点在于:git diff 本身不统计“有效代码行”,它连注释和空行都算;而 cloc 虽能过滤,但依赖语言定义准确性——比如自定义的 .vue 规则若漏掉 <script setup></script> 块,统计就失真。这层过滤逻辑必须显式声明,不能默认信任。

















