创建有多个作者的提交

本文内容

通过在提交消息中添加一个或多个 Co-authored-by 尾行，可将提交归属于多个作者。合作提交在 GitHub。

必需的合作作者信息

向提交添加合作作者之前，您必须知道用于每个合作作者的适当电子邮件地址。为使合作作者的提交计为贡献，必须使用与他们在 GitHub.com 上的帐户相关联的电子邮件。

如果用户选择将其电子邮件地址保密，则应使用其 GitHub 提供的 no-reply 电子邮件地址来保护其隐私。否则，合作作者的电子邮件地址将在提交消息中公开。如果要保持电子邮件地址的私密性，可选择使用 GitHub 为 Git 操作提供的 no-reply 电子邮件地址，并要求其他共同作者在提交尾行中列出你的 no-reply 电子邮件地址。

有关详细信息，请参阅“设置提交电子邮件地址”。

提示：通过分享此信息可帮助共同作者找到其首选电子邮件地址：

若要查找 GitHub 提供的 no-reply 电子邮件地址，请导航至“将我的电子邮件地址保密”下的电子邮件设置页面。
若要在计算机上查找用于配置 Git 的电子邮件地址，请在命令行上运行 git config user.email。

使用 GitHub Desktop 创建合作提交

可以使用 GitHub Desktop 创建合作提交。有关详细信息，请参阅“在 GitHub Desktop 中提交并审查对项目的更改”和 GitHub Desktop。

在命令行上创建合作提交

收集每位合作作者的姓名和电子邮件地址。如果有人选择保密其电子邮件地址，你应使用他们的 GitHub 提供的 no-reply 电子邮件地址以保护他们的隐私。
输入提交消息以及简短、有意义的更改描述。在提交描述后，不要加上右引号，而是添加两个空行。
```
$ git commit -m "Refactor usability tests.
>
>
```
提示： 如果在命令行上使用文本编辑器来键入提交消息，请确保在提交描述的末尾和 Co-authored-by: 提交尾部之间有两个换行符。
在提交消息的下一行，根据每个共同作者的特定信息键入 Co-authored-by: name <name@example.com>。在合作作者的信息后面，添加一个右引号。

如果要添加多个共同作者，请为每个共同作者键入一个 Co-authored-by: 提交尾行。不要在每个合著者行之间添加空白行。
```
$ git commit -m "Refactor usability tests.
>
>
Co-authored-by: NAME <NAME@EXAMPLE.COM>
Co-authored-by: ANOTHER-NAME <ANOTHER-NAME@EXAMPLE.COM>"
```

在下次推送时，新的提交和消息将显示在 GitHub.com 上。有关详细信息，请参阅“推送提交到远程仓库”。

在 GitHub

上创建合作提交

在 GitHub 上使用 Web 编辑器对文件进行更改后，可通过在提交消息中添加 Co-authored-by: 尾行来创建共同创作的提交。

收集每位合作作者的姓名和电子邮件地址。如果有人选择保密其电子邮件地址，你应使用他们的 GitHub 提供的 no-reply 电子邮件地址以保护他们的隐私。
单击“提交更改...”
在“提交消息”字段中，键入简短、有意义的提交消息，以描述所做的更改。
在提交消息下方的文本框中，根据每个共同作者的特定信息添加 Co-authored-by: name <name@example.com>。如果要添加多个共同作者，请为每个共同作者键入一个 Co-authored-by: 提交尾行。
单击“提交更改”或“建议更改” 。

新的提交和消息将显示在 GitHub.com 上。

延伸阅读

"查看项目的贡献者"
“更改提交消息”
GitHub Desktop 文档中的“在 GitHub Desktop 中提交并审查对项目的更改”