Git 重命名本地与远程分支的方法

分支名写错、命名规范变了、或者临时分支要转正，都需要改名。本地改名很简单一条命令就完事，麻烦的是远程：git 没有提供"重命名远程分支"的命令，服务端能做的只有创建和删除引用，所以远程改名实际上是"推一个新名字上去 + 删掉旧名字"这两步的组合。

这里最需要留神的是删除远程分支那一步，它属于破坏性操作。下面把本地和远程两种情况分开写清楚，并说明改名后跟踪关系该怎么重建。

重命名本地分支

在当前需要被重命名的分支

-m 是 --move 的缩写。只给一个参数时，git 把当前所在分支改成这个名字。这个操作只是改了 .git 里的一个引用名，提交历史、工作区文件都不动，所以很安全。

git branch -m new_branch_name

不在需要被重命名的分支

不用先切过去，给两个参数即可，第一个是旧名第二个是新名。顺序写反会把现有分支覆盖出问题，多确认一遍。

git branch -m old_branch_name new_branch_name

如果新名字已经被另一个分支占用，git 会拒绝执行并报 already exists。确认要覆盖的话可以用大写 -M 强制，但那会让被覆盖的分支指向丢失，未合并的提交就只能靠 git reflog 找回来了，非必要不要用。

重命名远端分支

远程改名分四步，顺序建议是先推新名再删旧名，这样中间任何一步失败，代码都还在远程有一份，不会出现短暂的"两边都没有"。

重命名本地分支

第一步仍然是本地改名，远程操作都基于本地这个新名字来推。

git branch -m new_branch_name

删除远程分支

所以推荐把这一步放到"上传新命名的本地分支"之后再做。如果远程仓库对分支设了保护规则（GitHub 的 main、master 默认受保护），这条命令会被服务端直接拒绝，需要先去仓库设置里解除保护。

git push --delete origin old_branch_name

上传新命名的本地分支

git push origin new_branch_name

这条更推荐的写法是加上 -u（等价于 --set-upstream），推送的同时就把跟踪关系建好，省掉后面单独设置的那一步：

git push origin -u new_branch_name

关联修改后的本地分支与远程分支

如果上一步没加 -u，就需要手动补这条。跟踪关系（upstream）的作用是让我们之后能直接敲 git pull 和 git push 而不用每次都写远程名和分支名，同时 git status 才能告诉我们"领先远程几个提交"。

git branch --set-upstream-to origin/new_branch_name

验证结果

改完之后确认一遍。先看本地分支和它们各自的上游：

git branch -vv

输出里每个分支后面方括号里的就是它跟踪的远程分支，如果显示的还是旧名字或者干脆没有方括号，说明跟踪关系没设对。

再看远程实际还剩哪些分支：

git fetch --prune
git branch -r

--prune 会清掉本地缓存的、远程已经不存在的跟踪引用。少了这一步，旧分支名会一直挂在 git branch -r 的输出里，让我们误以为远程没删干净。这个清理只动本地缓存，不碰服务器，是安全操作。