跳至主要内容

创建具有多个作者的提交

您可以通过向提交消息添加一个或多个 Co-authored-by 尾随信息,将提交归因于多个作者。共同创作的提交在 GitHub 上可见。

必需的共同作者信息

在向提交添加共同作者之前,您必须知道每个共同作者要使用的适当电子邮件。为了使共同作者的提交算作贡献,您必须使用与他们在 GitHub.com 上的帐户关联的电子邮件。

如果某人选择将他们的电子邮件地址保密,您应该使用他们提供的 GitHub no-reply 电子邮件来保护他们的隐私。否则,共同作者的电子邮件将在提交消息中公开。如果您想将您的电子邮件保密,您可以选择对 Git 操作使用 GitHub 提供的 no-reply 电子邮件,并要求其他共同作者在提交尾随信息中列出您的 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 上的 Web 编辑器对文件进行更改后,你可以通过向提交信息添加 Co-authored-by: 尾部来创建合著提交。

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

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

延伸阅读