原文:How to Rename a Local or Remote Branch in Git,作者:Kolade Chris

Git 是一个版本控制系统,软件开发人员使用它来跟踪其应用程序中的更改并与他人协作。

Git 的一个有用特性是分支。开发人员们在将自己的更改与原始代码合并之前可以在不同的分支中工作。

你还可以在不影响原始代码的情况下在不同的分支上添加新功能并修复错误。

有时,由于拼写错误或其他错误,你可能想要更改分支的名称,这就是我将在本指南中向你展示的内容。

如何重命名本地 Git 分支

第 1 步:要查看你的分支,请运行 git branch --list  或 git branch -a

ss-1-2

第 2 步:通过运行 git checkout branch-name 切换到要重命名的分支。

在这个示例中,我将切换到 mistake-fixes 分支,将其重命名为 bug-fixes

要切换分支,请运行 git switch branch-namegit checkout branch-name

第 3 步:要重命名分支,请运行 git branch -m new-name

ss-2-2

你可以看到分支已从 mistake-fixes 重命名为 bug-fixes

如果你在另一个分支上,例如 main,并且你想从那里重命名分支,请运行 git branch -m old-name new-name

注意:确保通过运行 git branch -a 查看所有分支来验证分支是否已重命名。

如何重命名远程 Git 分支

重命名远程分支不像重命名本地分支那么简单。

准确地说,重命名远程分支不是直接的——你必须删除旧的远程分支名称,然后将新的分支名称推送到 repo。

按照以下步骤重命名远程 git 分支:

第 1 步:通过运行 git push origin --delete old-branch-name 删除旧名称

在我一直使用的示例中,这将是 git push origin --delete mistake-fixes

ss-3-1

第 2 步:通过运行 git push origin -u new-branch-name 将上游分支重置为新本地分支的名称。

因此,在这个例子中,这将是 git push origin -u bug-fixes

ss-4-1

要确认你已成功重命名远程仓库,请登录你的网站并检查仓库。

在本教程的情况下,我使用 GitHub 作为客户端,并且重命名成功:

ss-5-1

小结

分支是 Git 的一个很棒的特性,它可以让你的托管软件项目更安全。

通常,在本地和远程重命名分支可能是不可避免的,这就是为什么我写这篇文章来帮助你重命名分支,避免出现代价高昂的错误。

如果你觉得这篇文章有帮助,请不要犹豫,与你的朋友和家人分享它。