git .mailmap 使用

.mailmap 文件用于在 Git 项目中规范化和修正提交历史记录中的作者信息。通常，开发者在提交代码时可能会使用不同的电子邮件地址或名字，这可能导致项目的提交历史看起来混乱不一致。通过使用 .mailmap 文件，你可以将这些不同的身份映射到一个统一的名字和电子邮件地址。

配置

1. 创建 .mailmap 文件。基本格式如下：

   new_name <new_email> old_name <old_email>
   <new_email> <old_email>
   new_name <new_email> old_name
   

2. 使用 .mailmap 文件

一旦 .mailmap 文件被创建并添加到项目中，git 会自动在一些命令（如 git shortlog 和 git log --pretty=full）中使用它来显示规范化后的作者信息。

示例

假设你的项目中有如下提交历史：

• Alice alice@old-email.com
• Bob bob@new-email.com
• A. Smith alice@old-email.com

你希望将 Alice 的旧邮箱和名字映射到新的邮箱和名字，.mailmap 文件可以这样写：

Alice Johnson <alice@new-email.com> Alice <alice@old-email.com>
Alice Johnson <alice@new-email.com> A. Smith <alice@old-email.com>

在有了这个 .mailmap 文件后，执行 git shortlog 时，Git 会将这些提交统一显示为来自 Alice Johnson alice@new-email.com。

参见：gitmailmap | Git Documentation