git shortlog 命令（建议收藏）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Git 版本控制系统中，团队协作的代码管理往往需要快速了解谁贡献了哪些代码，或者某个功能模块的修改历史。此时，git shortlog 命令就像一位“代码贡献的指挥官”，能以简洁直观的方式统计开发者提交的代码量，帮助团队成员或项目管理者高效分析项目动态。对于编程初学者而言，掌握这一命令能快速熟悉项目参与者的贡献分布；对于中级开发者，它则能辅助优化协作流程或排查历史提交中的问题。本文将从基础用法到高级技巧，逐步解析这一实用工具。

一、基础语法解析：从简单到复杂

1.1 命令核心功能

git shortlog 的核心作用是统计指定范围内所有提交的作者（Author），并按作者分组显示其提交的次数和摘要。其最基础的语法为：

git shortlog

执行后，Git 会默认统计当前分支下所有提交记录，并按作者分组列出提交次数及摘要的简要列表。例如：

   10 John Doe (2023-09-01)
     (commit) feat: 添加登录功能
     (commit) docs: 更新文档说明
    ...
    5 Alice Smith (2023-08-25)
     (commit) fix: 修复支付接口 bug
     ...

1.2 参数组合与输出优化

通过添加参数，可进一步控制输出的格式和统计范围。以下是关键参数及其作用：

• -s 或 --summary：仅显示提交次数和作者名，不列出具体提交内容。
• -n 或 --numbered：按提交次数降序排列作者。
• -e 或 --email：显示作者的邮箱地址，便于身份验证。

示例 1：按提交量排序并显示邮箱

git shortlog -sne

输出结果可能如下：

  15 John Doe <john.doe@example.com>
   9 Alice Smith <alice.smith@example.com>
   3 Bob Lee <bob.lee@example.com>

1.3 图表化理解参数作用

可以将参数组合想象为“过滤器”和“排序器”：

• -s 是“简洁模式”：去掉冗余的提交细节，只保留关键数据。
• -n 是“数字排序器”：根据提交次数将作者从高到低排列，如同给团队成员的贡献“排座位”。
• -e 是“扩展信息”：添加邮箱地址，就像给每个贡献者贴上“身份标签”。

二、统计维度扩展：按分支、时间或文件筛选

2.1 统计指定分支或范围

通过结合 Git 的范围语法（如 HEAD~10 或分支名），可限制统计的提交范围。例如：

git shortlog origin/main..HEAD

此命令会统计当前分支（HEAD）相对于主分支（origin/main）的新增提交，适用于查看某个特性分支的贡献者分布。

2.2 时间过滤：聚焦特定时间段

使用 --since 和 --until 参数可筛选某个时间段内的提交。例如：

git shortlog --since="2 weeks ago" --until="yesterday"

此命令将统计过去两周内的提交，帮助分析团队近期的活跃度。

2.3 按文件路径统计：定位模块贡献者

若需了解某个文件或目录的贡献者，可结合 git log 的路径筛选功能：

git log -- path/to/file | git shortlog -sn

例如，统计 src/auth 目录的贡献量：

git log -- src/auth | git shortlog -sn

输出可能为：

  7 Alice Smith <alice.smith@example.com>
  3 John Doe <john.doe@example.com>

三、实战案例：从真实场景看命令应用

3.1 案例 1：开源项目的贡献者排名

假设有一个开源项目 my-project，团队希望统计过去一个月内所有贡献者的提交量。执行以下命令：

git shortlog --since="1 month ago" -sn

输出结果可帮助团队识别哪些开发者近期活跃度最高，便于后续激励或任务分配。

3.2 案例 2：排查某功能模块的代码作者

假设需要确定 src/payment 目录的代码主要由谁编写，执行：

git log -- src/payment | git shortlog -sne

若发现某开发者提交占比过高，可能提示需要代码审查或任务分摊。

3.3 案例 3：合并多分支的贡献统计

在合并 feature/a 和 feature/b 分支到主分支后，统计两分支的总贡献量：

git shortlog origin/main..feature/a feature/b -sn

此命令能快速对比两个分支的代码贡献者分布。

四、进阶技巧：与 Git 其他命令的协同

4.1 结合 git log 的 --author 参数

若需统计特定开发者的提交，可先过滤日志再调用 shortlog：

git log --author="Alice" | git shortlog -sn

此命令会列出所有名为 Alice 的开发者提交的统计结果。

4.2 统计提交类型（如 feat、fix）

通过 git log 的 --grep 参数，可按提交信息中的关键词筛选统计。例如：

git log --grep="feat" | git shortlog -sn

此命令会统计所有包含 feat（功能开发）标签的提交量。

4.3 输出为 CSV 格式

若需将统计结果导入表格工具，可重定向输出到文件：

git shortlog -sne > contribution_stats.csv

文件内容将类似：

15 John Doe <john.doe@example.com>
9 Alice Smith <alice.smith@example.com>

五、常见问题与注意事项

5.1 参数组合的限制

某些参数组合可能产生冲突。例如，-n（按次数排序）和 -k（按字母排序）不能同时使用。若需按字母排序，需单独使用 -k：

git shortlog -sk

5.2 大项目中的性能优化

对于超大规模仓库（如超过 10 万次提交），git shortlog 可能运行缓慢。此时建议：

1. 结合 --max-count 限制统计提交数量：

   git shortlog --max-count=1000 -sn
   

2. 使用 git rev-list 先筛选提交，再传递给 git shortlog：

   git rev-list HEAD | xargs git shortlog -sn
   

5.3 区分作者（Author）与提交者（Committer）

默认情况下，git shortlog 统计的是 Author 信息。若需统计 Committer（如合并代码的人），需添加 --committer 参数：

git shortlog --committer -sn

结论

git shortlog 命令是 Git 工具链中一款高效的数据分析工具，尤其适合团队协作场景下的贡献可视化。通过掌握其基础语法、参数组合及与 Git 其他命令的协同，开发者能快速定位关键贡献者、优化协作流程或生成项目报告。对于初学者，建议从简单参数（如 -sn）开始实践；中级开发者则可尝试结合 --since、--grep 等进阶选项，挖掘更多隐藏价值。随着项目复杂度的提升，善用 shortlog 将成为提升团队效率的“隐形武器”。

持续学习 Git 的高级功能，结合实际场景灵活运用，开发者能更从容地应对复杂的版本管理需求。