Skip to main content

重命名仓库

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

重命名仓库时,除项目网站 URL 外,所有现有信息将自动重定向到新名称,包括:

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

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

除了重定向 Web 流量之外,所有针对先前位置的 git clonegit fetchgit push 操作都将继续跟在新位置上的方式一样运行。 不过,为了减少混淆,我们强烈建议将任何现有的本地克隆更新为指向新仓库 URL。 可以通过在命令行上使用 git remote 完成此操作:

git remote set-url origin NEW_URL

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

如果计划重命名具有 GitHub Pages 网站的仓库,建议对网站使用自定义域。 这可确保重命名仓库不会影响网站的 URL。 有关详细信息,请参阅“关于自定义域名和 GitHub 页面”。

注意:GitHub 不会将调用重定向到由重命名存储库托管的操作。 使用该操作的任何工作流都将失败并出现错误 repository not found。 而是创建一个新存储库并使用新名称执行操作,并将旧存储库存档。 有关详细信息,请参阅“存档仓库”。

警告:如果将来在你的帐户下创建新存储库,请不要重复使用重命名存储库的原始名称。 如果这样做,重定向到重命名的存储库将不再有效。

  1. 在 GitHub 上,导航到存储库的主页面。

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

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在“存储库名称”字段中,键入存储库的新名称。

  4. 单击“重命名”。