更改您的 GitHub 用户名

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

本文内容

关于用户名更改

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

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

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

更改用户名后，您的旧用户名将可供任何人使用。大多数对您在旧用户名下的仓库的引用会自动更改为新用户名。但是，某些指向您个人资料的链接不会自动重定向。

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

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

如果您是拥有托管用户的企业成员，则无法更改您的用户名。有关更多信息，请参阅“GitHub 帐户类型”。

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

如果帐户命名空间包含存储在 GitHub Packages 注册表中的任何软件包或容器镜像，GitHub 会将软件包和容器镜像转移到新命名空间。通过重命名您的帐户，您可能会破坏依赖于这些软件包的项目。如果命名空间包含任何公开的容器镜像，并且下载次数超过 5,000 次，则在您重命名帐户时，这些容器镜像的完整旧名称 (OLD-NAMESPACE/IMAGE-NAME) 将永久停用，以确保容器镜像名称在将来无法重复使用。

存储库引用

更改用户名后，GitHub 会自动重定向到您的存储库的引用。

  • 指向您现有存储库的网络链接将继续有效。这可能需要几分钟才能完成，具体取决于您进行更改的时间。
  • 从您的本地存储库克隆到旧远程跟踪 URL 的命令行推送将继续有效。

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

指向您以前个人资料页面的链接

更改用户名后，指向您先前个人资料页面的链接（例如 https://github.com/previoususername）将返回 404 错误。我们建议您更新 GitHub.com 上您帐户的任何链接，例如您的 LinkedIn 或 Twitter 个人资料。

您的 Git 提交

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

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

警告

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

您的 gist

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

CODEOWNERS 文件

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

更改用户名

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

进一步阅读