必需的共同作者信息
在向提交添加共同作者之前,您必须了解每位共同作者的正确邮箱。若要使共同作者的提交计入贡献,必须使用与其 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。
在命令行创建共同作者提交
-
收集每位共同作者的姓名和电子邮件地址。如果某人选择将其邮箱设为私密,您应使用其 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 使用网页编辑器对文件进行修改后,您可以通过在提交信息中添加 Co-authored-by: 附注来创建共同作者提交。
- 收集每位共同作者的姓名和电子邮件地址。如果某人选择将其邮箱设为私密,您应使用其 GitHub 提供的
no-reply邮箱以保护其隐私。 - 点击 提交更改...
- 在 “Commit message” 字段中,输入简短且有意义的提交信息,描述您所做的更改。
- 在提交信息下方的文本框中,添加
Co-authored-by: name <name@example.com>,并为每位共同作者填写相应信息。如果添加多个共同作者,请为每位共同作者单独占一行并使用Co-authored-by:附注。 - 点击 提交更改 或 提议更改。
新的提交及其信息将显示在 GitHub.com 上。
延伸阅读
- 查看项目的贡献者
- 更改提交信息
- 在 GitHub Desktop 中提交并审查项目更改(位于 GitHub Desktop 文档中)