记忆转储 
如何安全地重命名 Git 分支（本地 + 远程）
752 字
4 分钟
如何安全地重命名 Git 分支（本地 + 远程）
在日常开发中，我们有时需要修改已经创建好的 Git 分支名称。
常见场景包括：修正命名错误、统一命名规范、或者在分支创建后补充更准确的描述。
本文将介绍本地 + 远程完整重命名的方法，并额外说明使用 TortoiseGit（小乌龟） 时的操作步骤。
一、核心原则
重命名分支只是修改引用名称，不会改变任何提交历史。
- 分支与其他分支（例如
main/release）的祖先关系保持不变 - 已有的 commit 记录全部保留
- 不会导致历史断裂
因此可以放心操作。
二、命令行方式（推荐）
1. 重命名本地分支
如果当前正处于要改名的分支上：
git branch -m 新分支名如果当前在其他分支上：
git branch -m 旧分支名 新分支名2. 推送新分支到远程
git push origin -u 新分支名-u 参数会同时设置上游跟踪关系，后续可直接使用 git push / git pull。
3. 删除远程旧分支
确认新分支已成功推送后，再删除旧分支：
git push origin --delete 旧分支名4. 清理本地远程跟踪信息
git fetch origin --prune执行后，本地将不再显示已删除的远程分支。
三、TortoiseGit（小乌龟）图形化操作
公司内如果统一使用 TortoiseGit，可按以下步骤操作：
1. 获取最新远程信息
- 在仓库文件夹上右键
- 选择 TortoiseGit → Fetch…
- 勾选 Prune（清理已删除的远程分支信息）
- 点击 OK
2. 切换到新分支
- 再次右键 → TortoiseGit → Switch/Checkout…
- 在 Branch 列表中选择新的分支名
- 点击 OK
3. 删除远程旧分支（可选）
- 右键 → TortoiseGit → Browse References…
- 找到远程旧分支（
remotes/origin/旧分支名） - 右键选择 Delete
注意：删除前请确认新分支已经成功推送到远程。
四、操作时的注意事项
-
先推送新分支，再删除旧分支
顺序很重要，避免中间出现“分支丢失”的情况。 -
分支名包含空格或特殊字符时
命令行中务必使用双引号包裹完整分支名。 -
本地有未提交修改时
建议先Commit或Stash，再进行切换/重命名操作。 -
团队协作提醒
重命名后，建议在团队群组中简单通知，并告知其他人如何切换到新分支，避免他人继续使用旧分支名。
五、总结
| 步骤 | 命令行 | TortoiseGit |
|---|---|---|
| 重命名本地 | git branch -m 新名字 | 右键 → Rename（部分版本支持） |
| 推送新分支 | git push -u origin 新名字 | 推送时选择新分支 |
| 删除远程旧分支 | git push origin --delete 旧名字 | Browse References → Delete |
| 清理跟踪信息 | git fetch --prune | Fetch 时勾选 Prune |
按照以上流程操作，即可安全完成分支重命名，既不会丢失历史，也不会破坏与其他分支的关联关系。
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！
相关文章 智能推荐
1
Git在push的时候防止出现Merge曲线的办法
开发工具 commit后忘记 Push，过几天直接 Pull 产生巨大的 Merge 分叉线时修复的办法。
2
Git 忽略已被跟踪文件的本地修改
开发工具 使用 assume-unchanged 标记实现本地配置文件的静默忽略，同时不影响远程更新。
3
DBeaver 与 A5M2 的对比
工作生活 对比 DBeaver 与 A5:SQL Mk-2 的差异。
4
IntelliJ IDEA 日文注释对齐问题完整排查记录
开发工具 IDEA 中全角半角混排注释对齐错位的问题。从 MS Gothic 无效，到发现 Antialiasing 的关键作用，再到 Sarasa Mono 一键解决，最终找到英文美观 + 对齐稳定的终极配置。
5
GitHub 仓库同步与冲突解决
开发工具 记录一次在 VS Code 中合并原作者大规模更新并手动解决冲突的实战流程。
随机文章 随机推荐