差异摘要是什么

git diff --stat 把改动压缩成每个文件一行：文件名、改动条数，以及一串用加号减号画出的比例条。它不展开具体内容，只回答「改了哪些文件、规模多大」。评审时先看摘要掌握全貌，再决定深入哪些文件，比从头读整份补丁高效。

几种机器可读的变体

需要脚本处理时，--numstat 用制表符分隔出新增与删除的行数，字段位置固定；--name-only 只给文件名；--name-status 每行给出状态字母与路径，能区分新增、修改、删除与重命名。三者都能配合提交范围或路径过滤一起使用。

基本信息

典型使用场景

• 评审摸底：先看规模，再安排阅读顺序
• 提交前确认：检查是否夹带了不相关的大文件改动
• 脚本统计：用 --numstat 汇总改动行数
• 生成清单：用 --name-only 或 --name-status 输出改动文件列表
• 版本对比：比较两个标签之间的改动规模

常用示例

git diff --stat                 # 未暂存改动的摘要
git diff --staged --stat        # 待提交改动的摘要
git diff --numstat              # 供脚本解析的行数统计
git diff --name-only            # 只列文件名
git diff --name-status HEAD~3   # 状态字母加路径
git diff --stat v1.4.0 v1.5.0   # 两个版本之间的规模

几种摘要格式