跳到主要内容

使用多个作者创建提交

您可以通过向提交消息添加一个或多个Co-authored-by 尾注来将提交归属于多个作者。协作提交在 GitHub 上可见。

必需的共同作者信息

在您可以向提交添加共同作者之前,您必须知道每个共同作者使用的相应电子邮件地址。为了使共同作者的提交计入贡献,您必须使用与其 GitHub.com 帐户关联的电子邮件地址。

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

有关更多信息,请参阅“设置您的提交电子邮件地址”。

提示

您可以通过共享此信息来帮助共同作者找到他们首选的电子邮件地址。

  • 要查找您的 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.
    >
    >
    

    提示

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

  3. 在提交消息的下一行,键入Co-authored-by: name <[email protected]>,其中包含每个共同作者的具体信息。在共同作者信息之后,添加一个结束引号。

    如果您要添加多个共同作者,请为每个共同作者提供他们自己的行和Co-authored-by: 提交尾注。不要在每个共同作者行之间添加空行。

    $ git commit -m "Refactor usability tests.
    >
    >
    Co-authored-by: NAME <[email protected]>
    Co-authored-by: ANOTHER-NAME <[email protected]>"
    

下次推送时,新的提交和消息将显示在 GitHub.com 上。有关更多信息,请参阅“将提交推送到远程存储库”。

在 GitHub 上创建共同创作的提交

在使用 GitHub 上的网络编辑器修改文件后,您可以通过向提交消息添加Co-authored-by: 尾注来创建共同创作的提交。

  1. 收集每个共同作者的姓名和电子邮件地址。如果有人选择将其电子邮件地址设为私密,则应使用其 GitHub 提供的no-reply 电子邮件来保护其隐私。
  2. 点击提交更改...
  3. 在“提交消息”字段中,键入简短、有意义的提交消息,以描述您所做的更改。
  4. 在提交消息下方的文本框中,添加Co-authored-by: name <[email protected]>,其中包含每个共同作者的具体信息。如果您要添加多个共同作者,请为每个共同作者提供他们自己的行和Co-authored-by: 提交尾注。
  5. 点击提交更改提出更改

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

进一步阅读