首页/开发/Git 与协作速查/git mailmap 归并作者署名
Git 基础与命令88 条

git mailmap 归并作者署名

用 .mailmap 把同一人的多个姓名与邮箱映射到一个规范署名,影响 shortlog、log 等展示结果。

Git 与协作速查开发更新于 2026-10-12
位置仓库根 .mailmap(或用 mailmap.file 指定)
格式规范名 <规范邮箱> <其他邮箱>
生效范围shortlog/blame/log 等展示与统计

示例内容

示例内容
# 规范署名 规范邮箱 旧邮箱
Zhang San <zhangsan@example.com> <zhangsan@old-mail.com>
Zhang San <zhangsan@example.com> Old Name <old@example.com>
合并历史署名后,贡献者名单不再重复出现同一个人。

易错点

  • 邮箱拼写与大小写要完全匹配才能命中映射
  • 平台贡献图按平台侧身份计算,.mailmap 只影响本地命令输出

数据来源与参考

  • Git 官方文档:git-shortlog(mailmap)
  • Git 官方文档:gitmailmap
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌