跳至主要内容

重命名分支

您可以更改仓库中分支的名称。

谁可以使用此功能?

拥有仓库写入权限的用户可以重命名仓库中的分支,除非该分支是 默认分支受保护分支。拥有管理员权限的用户可以重命名默认分支和受保护分支。

关于重命名分支

您可以在 GitHub.com 上的仓库中重命名分支。有关分支的更多信息,请参阅 关于分支

当您重命名分支时,包含旧分支名称的所有 URL 都会自动重定向到对应的已重命名分支的 URL。分支保护策略也会相应更新,开放的拉取请求(包括来自 fork 的请求)和草稿发布的基准分支也会更新。如果被重命名的分支是开放拉取请求的头部分支,该拉取请求将被关闭。

如果仓库的默认分支被重命名,GitHub 会在仓库主页提供说明,指导贡献者更新本地 Git 环境。

虽然文件 URL 会自动重定向,但原始文件 URL 不会被重定向。此外,如果用户使用之前的分支名称执行 git pull,GitHub 不会进行任何重定向。

GitHub Actions 工作流不会跟随重命名,因此如果您的仓库发布了一个 Action,任何使用 @{old-branch-name} 的人都会出现错误。您应考虑创建一个包含原始内容的新分支,并额外提交一次,说明该分支名称即将关闭并建议用户迁移到新分支名称。

适用于仓库分支的组织规则集将不再允许仓库管理员重命名目标仓库的分支或将默认分支更改为其他分支。只要拥有相应权限,仓库管理员仍可创建和删除分支。

重命名分支

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

  2. 在左侧的文件树视图中,选择分支下拉菜单,然后点击 查看所有分支。您也可以在集成文件编辑器的顶部找到分支下拉菜单。

    Screenshot of the file tree view for a repository. A dropdown menu for branches is expanded and outlined in dark orange.

  3. 在您想要重命名的分支旁边,选择下拉菜单,然后点击 重命名分支

  4. 为该分支输入一个新名称。

  5. 查看有关本地环境的信息,然后点击 重命名分支

分支名称更改后更新本地克隆

在 GitHub 上的仓库中重命名分支后,任何拥有该仓库本地克隆的协作者都需要更新其克隆。

在计算机上本地克隆的仓库中,运行以下命令来更新默认分支的名称。

git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
git fetch origin
git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
git remote set-head origin -a

可选地,运行以下命令以移除对旧分支名称的跟踪引用。

git remote prune origin
© . This site is unofficial and not affiliated with GitHub, Inc.