Skip to main content

创建有多个作者的提交

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

必需的合作作者信息

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

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

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

Tip

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

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

使用 GitHub Desktop 创建合作提交

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

在命令行上创建合作提交

  1. 收集每位合作作者的姓名和电子邮件地址。 如果有人选择保密其电子邮件地址,你应使用他们的 GitHub 提供的 no-reply 电子邮件地址以保护他们的隐私。

  2. 输入提交消息以及简短、有意义的更改描述。 在提交描述后,不要加上右引号,而是添加两个空行。

    $ git commit -m "Refactor usability tests.
    >
    >
    

    Tip

    如果在命令行上使用文本编辑器来键入提交消息,请确保在提交描述的末尾和 Co-authored-by: 提交尾部之间有两个换行符。

  3. 在提交消息的下一行,根据每个共同作者的特定信息键入 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: 尾行来创建共同创作的提交。

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

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

其他阅读材料