重命名 GitHub 中的分支

Question

我刚刚使用

重命名了我的本地分支

git branch -m oldname newname

但这只会重命名分支的本地版本。如何在 GitHub 上重命名？

Answer 1

现在可以通过 GitHub API 使用分支重命名

你可以rename a branch with the GitHub REST API。

您可以轻松地run API commands via the gh CLI 都这样：

gh api "repos/{owner}/{repo}/branches/{branch}/rename" -f new_name={newBranch}

Answer 2

在 GitHub 端，您可以使用新的（2021 年 1 月）“Support for renaming an existing branch”（受保护的分支只能由管理员重命名，见末尾）

关注本教程：https://docs.github.com/en/github/administering-a-repository/renaming-a-branch

见“How do I rename branch on the GitHub website?”。

这是一种更好的方法，因为以这种方式重命名分支（在 github.com 上）将 (source)：

• 重新定位任何打开的拉取请求
• 根据分支更新任何草稿版本
• 移动任何明确引用旧名称的分支保护规则
• 更新用于构建 GitHub 页面的分支（如果适用）
• 在存储库主页上向存储库贡献者、维护者和管理员显示通知，其中包含更新存储库本地副本的说明
• 向 git push 到旧分支的贡献者显示通知
• 将对旧分支名称的 Web 请求重定向到新分支名称
• 在旧分支名称的 API 请求中返回“永久移动”响应

---

2021 年 12 月更新：

Restrict renaming protected branches to admins

现在，只有管理员可以重命名受分支保护规则保护的分支。

GitHub 允许仓库协作者重命名仓库中的每个分支，默认分支除外。

当协作者重命名分支时，适用于该分支的任何非通配符分支保护规则也会更改以匹配分支的新名称。

由于只有管理员可以修改分支保护规则，因此受保护分支的重命名现在仅限于管理员用户。

欲了解更多信息，请访问Renaming a branch和Managing a branch protection rule。

Answer 3

您可以在没有终端的情况下执行此操作。您只需要使用新名称创建一个分支，然后删除旧名称。

创建一个分支

在您的存储库的分支选择器中，只需开始输入一个新分支 姓名。它会给你创建一个新分支的选项：

它将从您当前的上下文中分支出来。例如，如果您在 错误修复分支，它将从错误修复创建一个新分支，而不是 掌握。而是查看提交或标签？它会分支你的代码 从那个特定的版本开始。

删除一个分支

您还会在存储库的“分支”页面中看到一个删除按钮：

作为额外的奖励，它还会为您提供分支的 Pull 的链接 请求，如果有的话。

我只是复制并粘贴以下内容：Create and delete branches

Answer 4

这是Hazarapet Tunanyan's 答案中的附加条件。

git branch -m old_branch new_branch         # Rename branch locally


git push origin :old_branch                 # Delete the old branch
# You might be getting an error doing the above step, skip to the next step

git push --set-upstream origin new_branch   # Push the new branch, set local branch to track the new remote

您在执行 git push origin :old_branch 时遇到错误，因为您尝试删除的 old_branch 可能是 默认分支。

只需执行其他2个步骤，然后转到github并从设置中更改默认分支，然后您就可以执行git push origin :old_branch。

Answer 5

如前所述，删除 GitHub 上的旧命令并重新推送，尽管使用的命令比必要的要冗长一些：

git push origin :name_of_the_old_branch_on_github
git push origin new_name_of_the_branch_that_is_local

稍微剖析一下命令，git push 命令本质上是：

git push <remote> <local_branch>:<remote_branch>

因此，在没有指定 local_branch 的情况下进行推送基本上意味着“从我的本地存储库中获取任何内容，并将其设为远程分支”。我一直认为这完全是笨拙的，但它就是这样做的。

从Git 1.7 开始，有一种用于删除远程分支的替代语法：

git push origin --delete name_of_the_remote_branch

正如 @void.pointer 在 cmets 中提到的那样

请注意，您可以将 2 个推送操作结合起来：

git push origin :old_branch new_branch

这将删除旧分支并推送新分支。

这可以变成一个简单的别名，将远程、原始分支和新分支名称作为参数，在~/.gitconfig：

[alias]
    branchm = "!git branch -m $2 $3 && git push $1 :$2 $3 -u #"

用法：

git branchm origin old_branch new_branch

请注意，shell 命令中的位置参数在较旧（2.8 之前？）版本的 Git 中存在问题，因此别名可能会根据 Git 版本而有所不同。详情请见this discussion。

Answer 6

1. 下载 Atlassian Sourcetree（免费）。
2. 导入存储库的本地克隆。
3. 在侧边栏中右键单击要重命名的分支。从上下文菜单中选择“重命名分支...”，然后重命名它。
4. 推送到原点。

Answer 7

在 Git 分支上，运行：

git branch -m old_name  new_name

这将修改本地存储库上的分支名称：

git push origin :old_name new_name

这会将修改后的名称推送到远程并删除旧分支：

git push origin -u new_name

它设置本地分支来跟踪远程分支。

这解决了问题。

Answer 8

三个简单的步骤

• git push origin head

• git branch -m old-branch-name new-branch-name

• git push origin head

Answer 9

就这么简单。为了在本地和远程重命名 Git 分支，请使用这个 sn-p（经过测试并且像魅力一样工作）：

git branch -m <oldBranchName> <newBranchName>
git push origin :<oldBranchName>
git push --set-upstream origin <newBranchName>

解释：

1. 重命名步骤：

Git 参考： 使用 -m 或 -M 选项， 将重命名为 。如果 有一个对应的 reflog，它被重命名以匹配 ，并创建一个 reflog 条目来记住分支 重命名。如果 存在，则必须使用 -M 强制重命名 发生。

1. 删除步骤：

Git 参考： git push origin :experimental 找到一个匹配实验性的 ref 原始存储库（例如 refs/heads/experimental），然后将其删除。

1. 远程存储库步骤更新（用于跟踪的上游参考）：

Git 参考： --set-upstream 对于每个最新或成功推送的分支，添加上游（跟踪）引用，由无参数使用 git-pull[1] 和其他命令。有关详细信息，请参阅 branch..merge in git-config[1].

Answer 10

在 Git 本地和远程重命名分支

1.重命名您的本地分支。

如果您在要重命名的分支上：

git branch -m new-name

如果你在不同的分支：

git branch -m old-name new-name

2。删除旧的远程分支并推送新的本地分支。

git push origin :old-name new-name

3.为新名称的本地分支重置上游分支。

切换到分支然后：

git push origin -u new-name

所以结论是：

git branch -m new-name
git push origin :old-name new-name
git push origin -u new-name

Answer 11

就我而言，我需要一个额外的命令，

git branch --unset-upstream

让我重命名的分支推送到origin newname。

（为了方便打字）我先git checkout oldname。 然后运行以下命令：

git branch -m newname <br/> git push origin :oldname*or*git push origin --delete oldname
git branch --unset-upstream
git push -u origin newname 或 @987654328 @

这个额外步骤可能只是必要的，因为我（倾向于）通过git push -u origin oldname 在我的分支上设置远程跟踪。这样，当我签出oldname 时，我随后只需要输入git push 而不是git push origin oldname。

如果我不在git push origin newbranch之前使用命令git branch --unset-upstream，git 重新创建 oldbranch并将newbranch推送到origin oldbranch --打败我的意图。

Answer 12

另一种方法是重命名以下文件：

1. 浏览您的项目目录。
2. 将.git/refs/head/[branch-name] 重命名为.git/refs/head/new-branch-name。
3. 将.git/refs/remotes/[all-remote-names]/[branch-name] 重命名为.git/refs/remotes/[all-remote-names]/new-branch-name。

重命名 head 和 remotes 在您的本地 PC 和在源/远程服务器上。

分支现在被重命名（本地和远程！）

---

注意

如果您当前的分支名称包含斜杠 (/)，Git 将创建如下目录：

当前分支名称： "awe/some/branch"

• .git/refs/head/awe/some/branch
• .git/refs/remotes/[all-remote-names]/awe/some/branch

希望分支名称： "new-branch-name"

1. 浏览您的项目目录。
2. 从.git/refs/*/awe/some/ 复制branch 文件。
3. 把它放在.git/refs/head/。
4. 从所有.git/refs/remotes/*/awe/some/中复制branch文件。
5. 将它们放入.git/refs/remotes/*/。
6. 将所有复制的branch文件重命名为new-branch-name。
7. 检查目录和文件结构现在是否如下所示：

• .git/refs/head/new-branch-name
• .git/refs/remotes/[all-remote-names]/new-branch-name

8. 在所有远程源/服务器（如果存在）上执行相同操作

• 信息：在远程服务器上通常没有 refs/remotes/* 目录，因为您已经在远程服务器上；）（好吧，也许在高级 Git 配置中它可能是可能的，但我有没见过）

分支现在从 awe/some/branch 重命名为 new-branch-name（本地和远程！）

分支名称中的目录已删除。

---

信息：这种方式可能不是最好的，但它仍然适用于可能对其他方式有问题的人

Answer 13

我找到了三个关于如何更改 Git 分支名称的命令，这些命令是一种更快的方法：

git branch -m old_branch new_branch         # Rename branch locally
git push origin :old_branch                 # Delete the old branch
git push --set-upstream origin new_branch   # Push the new branch, set local branch to track the new remote

如果您需要分步操作，可以阅读这篇精彩的文章：

How to Rename Git Local and Remote Branches

Answer 14

这篇文章展示了如何轻松地做到这一点。

1. 要重命名本地Git分支，我们可以使用Git branch -m命令修改名称：

    git branch -m feature1 feature2
   

2. 如果您只是在寻找重命名远程 Git 分支的命令，就是这样：

    git push -u origin feature2:feature3
   

   在执行此操作之前，请检查分支上是否没有标签。你可以通过git tag 做到这一点。

Answer 15

这对我有用：

1. 先创建新分支：

   git push github newname :refs/heads/newname
   

2. 在 GitHub 站点上，转到设置并将 默认分支 更改为 newname

3. 删除oldname

   git push github --delete oldname
   

Answer 16

以下命令对我有用：

git push origin :old-name-of-branch-on-github
git branch -m old-name-of-branch-on-github new-name-for-branch-you-want
git push origin new-name-for-branch-you-want

Answer 17

以下命令在本地重命名分支，删除远程位置上的旧分支并推送新分支，设置本地分支跟踪新远程：

git branch -m old_branch new_branch
git push origin :old_branch
git push --set-upstream origin new_branch

Answer 18

只需删除旧分支并创建新分支。

示例（仅重命名远程分支）：

git push origin :refs/heads/oldname
git push origin newname:refs/heads/newname

您可能还应该重命名本地分支并更改推/拉位置的设置。