更改您的 GitHub 用户名

您可以更改 GitHub 帐户的用户名。

本文内容

关于用户名更改

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

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

如果您不拥有该名称的商标，您可以选择另一个用户名或保留当前用户名。GitHub 支持无法为您释放不可用的用户名。有关更多信息，请参阅“更改您的用户名”。

更改用户名后，您的旧用户名将在 90 天内无法供任何人认领。大多数对您旧用户名下代码库的引用会自动更改为新用户名。但是，某些指向您个人资料的链接不会自动重定向。

GitHub 无法为以下内容设置重定向：

  • 使用您的旧用户名进行@提及
  • 指向包含您的旧用户名的gist的链接

如果您是拥有托管用户的企业的成员，则无法更改您的用户名。有关更多信息，请参阅“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 错误。我们建议您更新从其他地方（例如您的 LinkedIn 或 Twitter 个人资料）指向您个人资料的任何链接。

在 GitHub Mobile 上登录的帐户

在 GitHub Mobile 应用程序上登录的帐户可能会继续显示您的原始用户名，直到您注销为止。为确保显示您的更新后的用户名，我们建议您在每部移动设备上注销并重新登录您的帐户。

您的 Git 提交

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

如果您一直在使用 GitHub 提供的私有提交电子邮件地址，则重命名帐户后是否保留您的提交历史记录取决于电子邮件地址的格式。与您 GitHub 提供的 noreply 电子邮件地址关联的 Git 提交不会归属于您的新用户名，也不会显示在您的贡献图表中，除非您的 noreply 电子邮件地址采用 [email protected] 的形式。不包含数字 ID 的旧版 noreply 电子邮件地址在更改用户名后将不会与您的 GitHub 帐户关联。

警告

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

您的 gist

更改用户名后，任何公共或私有 gist 的 URL 也将更改，并且指向它们的先前链接将返回 404 错误。我们建议您更新您可能已共享这些 gist 的任何地方的链接。

CODEOWNERS 文件

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

更改您的用户名

  1. 在 GitHub 上任何页面的右上角，单击您的个人资料照片，然后单击 设置.
  2. 在左侧边栏中，单击 帐户。
  3. 在“更改用户名”部分，单击更改用户名。
  4. 阅读有关更改用户名的警告。如果您仍然想更改用户名，请单击我理解，让我们更改我的用户名。
  5. 输入新的用户名。
  6. 如果您选择的用户名可用，请单击更改我的用户名。如果您选择的用户名不可用，您可以尝试不同的用户名或您看到的建议之一。

进一步阅读