跳至主要内容

重命名仓库

如果你是组织所有者或拥有仓库的管理员权限,则可以重命名仓库。

重命名仓库时,除了项目站点 URL 外,所有现有信息都会自动重定向到新名称,包括

  • 问题
  • Wiki
  • 星标
  • 关注者

有关项目站点的更多信息,请参阅“关于 GitHub Pages”。

除了重定向网络流量外,所有目标为先前位置的 git clonegit fetchgit push 操作将继续像在新位置上执行一样工作。但是,为了减少混淆,我们强烈建议更新任何现有的本地克隆以指向新的仓库 URL。你可以使用命令行上的 git remote 来执行此操作。

git remote set-url origin NEW_URL

有关更多信息,请参阅“管理远程仓库”。

如果您计划重命名包含 GitHub Pages 站点的仓库,我们建议您为您的站点使用自定义域名。这可确保站点的 URL 不会受到仓库重命名操作的影响。有关更多信息,请参阅“关于自定义域名和 GitHub Pages”。

注意

GitHub 不会重定向对重命名仓库中托管的操作的调用。任何使用该操作的工作流都将失败,并显示错误 repository not found。请改用新名称创建新的仓库和操作,并将旧仓库存档。有关更多信息,请参阅“存档仓库”。

警告

如果您将来在您的帐户中创建新的仓库,请勿重复使用重命名仓库的原始名称。如果您这样做,则重命名仓库的重定向将不再起作用。

  1. 在 GitHub 上,导航到仓库的主页。

  2. 在您的仓库名称下方,单击 设置。如果您看不到“设置”选项卡,请选择下拉菜单,然后单击设置

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. 仓库名称字段中,键入仓库的新名称。

  4. 单击重命名