Skip to main content

更改 GitHub 用户名

如果你的实例使用内置身份验证,则可以在 GitHub 上更改帐户的用户名。

注意:如果你使用 LDAP 凭据或单一登录 (SSO) 登录 你的 GitHub Enterprise Server 实例,则只有本地管理员才能更改用户名。 有关 GitHub Enterprise Server 的身份验证方法的更多信息,请参阅“了解适用于企业的 IAM”。

关于用户名更改

您可以将用户名更改为当前未使用的其他用户名。

更改用户名后,您的旧用户名即可供其他人申请使用。 对旧用户名下仓库的大多数引用会自动更改为新用户名。 不过,指向您个人资料的某些链接不会自动重定向。

GitHub Enterprise Server 无法为以下各项设置重定向:

如果帐户命名空间包含存储在 GitHub Packages 注册表中的任何包或容器映像,则 GitHub 会将包和容器映像传输到新的命名空间。 重命名帐户可能会中断依赖于这些包的项目。

仓库引用

您更改用户名后,GitHub Enterprise Server 自动将引用重定向到您的仓库。

  • 指向现有仓库的 Web 链接仍然有效。 进行更改后,可能需要几分钟时间才能完成。
  • 从本地仓库克隆推送到旧的远程跟踪 URL 的命令行仍然有效。

如果旧用户名的新所有者创建与您的仓库同名的仓库,则会覆盖重定向条目,并且您的重定向将停止工作。 由于这种可能性,我们建议您在更改用户名后更新所有现有的远程仓库 URL。 有关详细信息,请参阅“管理远程仓库”。

更改用户名后,指向以前的配置文件页面的链接(例如 https://HOSTNAME/previoususername)将返回 404 错误。 建议从其他位置更新指向 你的 GitHub Enterprise Server 实例 帐户的所有链接。

您的 Git 提交

如果你的 Git 提交与添加到 GitHub 帐户的另一个电子邮件地址相关联,则它们将继续归属于你,并在你更改用户名后显示在贡献图中。 有关设置电子邮件地址的详细信息,请参阅“设置提交电子邮件地址”和“添加电子邮件地址到 GitHub 帐户”。

警告:

  • 用户名更改后,使用之前 GitHub Enterprise Server 提供的 noreply 电子邮件地址签名的已验证提交将失去其“已验证”状态。
  • 验证签名时,GitHub Enterprise Server 检查提交者或标记者的电子邮件地址是否与 GPG 密钥标识关联的一个电子邮件地址完全匹配。 此外,GitHub Enterprise Server 确认电子邮件地址已验证并链接到用户的帐户。 这可确保密钥属于您且您已创建提交或标记。 由于 noreply 电子邮件地址的用户名发生了更改,因此无法再验证这些提交。

你的 Gist

更改用户名后,任何公共或机密 Gist 的 URL 也将更改,并且之前指向这些 Gist 的链接将返回 404 错误。 建议在可能共享这些 Gist 的任何位置更新 Gist 的链接。

CODEOWNERS 文件

更改用户名后,需要手动更新包含旧用户名的 CODEOWNERS 文件。 在 GitHub 上查看 CODEOWNERS 文件时,如果文件包含任何未知用户或没有写权限的用户,将显示错误消息。 建议使用新用户名更新所有相关的 CODEOWNERS 文件。 有关详细信息,请参阅“关于代码所有者”。

更改用户名

  1. 在任何页面的右上角,单击个人资料照片,然后单击“设置”。

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. 在边栏中,单击“ 帐户”。

  3. 在“更改用户名”部分中,单击“更改用户名”。

延伸阅读