Skip to main content

更改 GitHub 用户名

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

关于用户名更改

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

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

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

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

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

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

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

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

仓库引用

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

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

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

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

您的 Git 提交

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

如果你一直使用 GitHub 提供的专用提交电子邮件地址,则帐户重命名后是否会保留你的提交历史记录取决于电子邮件地址的格式。 与 GitHub 提供的 noreply 电子邮件地址关联的 Git 提交不会归属于新用户名,也不会显示在贡献图中,除非 noreply 电子邮件地址采用 ID+USERNAME@users.noreply.github.com 形式。 更改用户名后,不包含数字 ID 的旧版 noreply 电子邮件地址将不会与 GitHub 帐户关联。

警告:

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

你的 Gist

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

CODEOWNERS 文件

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

更改用户名

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

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

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

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

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

  5. 键入新的用户名。

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

延伸阅读