跳至主要内容

创建包含多位作者的提交

您可以通过在提交信息中添加一个或多个 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 <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 使用网页编辑器对文件进行修改后,您可以通过在提交信息中添加 Co-authored-by: 附注来创建共同作者提交。

  1. 收集每位共同作者的姓名和电子邮件地址。如果某人选择将其邮箱设为私密,您应使用其 GitHub 提供的 no-reply 邮箱以保护其隐私。
  2. 点击 提交更改...
  3. 在 “Commit message” 字段中,输入简短且有意义的提交信息,描述您所做的更改。
  4. 在提交信息下方的文本框中,添加 Co-authored-by: name <name@example.com>,并为每位共同作者填写相应信息。如果添加多个共同作者,请为每位共同作者单独占一行并使用 Co-authored-by: 附注。
  5. 点击 提交更改提议更改

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

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.