Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

更改 GitHub 用户名

You can change the username for your account on GitHub.com.

注意:具有托管用户的企业 成员无法更改用户名。 企业的 IdP 管理员控制您的 GitHub Enterprise Cloud 用户名。 有关详细信息,请参阅“关于 Enterprise Managed Users”。

关于用户名更改

您可以将用户名更改为当前未使用的其他用户名。 如果所需的用户名不可用,请考虑其他名称或唯一变体。 使用数字、连字符或其他拼写可能有助于您找到仍可用的类似用户名。

如果你拥有该用户名的商标,可以在我们的商标政策页面上找到有关提出商标投诉的更多信息。

如果您没有该名称的商标,则可以选择其他用户名或保留当前用户名。 GitHub 支持 无法为您释放不可用的用户名。 有关详细信息,请参阅“更改用户名”。

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

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

如果你是 具有托管用户的企业 成员,则无法更改用户名。 有关详细信息,请参阅“GitHub 帐户类型”。

如果帐户命名空间包含的公共存储库包含 GitHub Marketplace 上列出的操作,或这些公共存储库在重命名帐户前一周内超过 100 次克隆或超过 100 次使用 GitHub Actions,则在重命名帐户时,GitHub 将永久停用旧所有者名称和存储库名称组合 (OLD-OWNER/REPOSITORY-NAME)。 如果尝试使用已停用的所有者名称和存储库名称组合创建存储库,你将看到错误:“存储库 <REPOSITORY_NAME> 已停用,无法重复使用。”

如果帐户命名空间包含存储在 GitHub Packages 注册表中的任何包或容器映像,则 GitHub 会将包和容器映像传输到新的命名空间。 重命名帐户可能会中断依赖于这些包的项目。如果命名空间包含任何下载量超过 5,000 次的公共容器映像,则在重命名帐户时,这些容器映像的完整旧名称 (OLD-NAMESPACE/IMAGE-NAME) 将永久停用,以确保将来不能重复使用该容器映像名称。

仓库引用

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

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

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

更改用户名后,指向以前的配置文件页面的链接(例如 https://github.com/previoususername)将返回 404 错误。 建议从其他位置更新指向 GitHub.com 帐户的所有链接,例如你的 LinkedIn 或 Twitter 个人资料。

您的 Git 提交

与你的 GitHub Enterprise Cloud 提供的 noreply 电子邮件地址关联的 Git 提交不会归于新的用户名,并且不会在你的贡献图中显示。如果你的 Git 提交与你已添加到 GitHub 帐户的其他电子邮件地址关联,包括基于 ID 的 GitHub Enterprise Cloud 提供的 noreply 电子邮件地址,它们在你更改用户名后将继续归于你并在你的贡献图中显示。 有关设置电子邮件地址的详细信息,请参阅“设置提交电子邮件地址”。

你的 Gist

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

CODEOWNERS 文件

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

更改用户名

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

    GitHub 帐户菜单的屏幕截图,其中显示了供用户查看和编辑其个人资料、内容和设置的选项。 菜单项“设置”用深橙色框出。

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

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

  4. 阅读有关更改用户名的警告。 如果你仍要更改用户名,请单击“我了解,让我们更改用户名”。 更改用户名警告按钮

  5. 键入新的用户名。 新用户名字段

  6. 如果你选择的用户名可用,请单击“更改用户名”。 如果您选择的用户名不可用,可以尝试其他用户名或您看到的建议之一。 更改用户名警告按钮

延伸阅读