git branch -m 是唯一真正重命名分支的操作，最稳妥方式是直接在目标分支上执行 git branch -m 新分支名；跨分支重命名需两参数形式，远程同步须手动删旧推新并设置上游。
git branch -m 重命名当前分支最稳妥
当前在哪个分支，就直接用 git branch -m 新分支名，这是最安全的方式。Git 会自动校验新名字是否合法（比如不能含空格、不能以 - 开头、不能和已有分支冲突），失败时直接报错，不会静默覆盖。
常见错误现象：git branch -m old new 写成两参数形式，但当前不在 old 分支上——这时 Git 不报错，却悄悄把当前分支改名成 new，而 old 分支根本没动，极易误以为操作成功。
- 只在当前分支上生效，不涉及远程；想同步远程得另走一步
- 如果新分支名已存在，命令直接失败，不会覆盖（这点比
mv谨慎） - Windows 下对大小写不敏感，
main→Main可能被忽略，建议加--force显式触发（但要确认无歧义）
git branch -m 重命名其他本地分支要指定旧名
不在目标分支上时，必须用 git branch -m 旧分支名 新分支名。Git 不允许跨分支“改名”，它本质是删旧 + 建新，只是原子化封装了。
使用场景：清理测试分支（如把 feat/login-temp 改成 feat/login），或统一命名规范（bugfix_2024 → fix/2024）。
- 旧分支名必须拼写完全准确，包括大小写和斜杠；输错会新建一个同名分支，原分支还在
- 如果旧分支名含特殊字符（如
.、~），需用引号包裹：git branch -m "hotfix.1.2" "fix/1.2" - 重命名后，该分支的本地 reflog 会保留，但 commit 关联的 branch 名已更新，不影响历史
重命名后 push 到远程需要先删旧再推新
Git 不会自动同步分支重命名到远程——它只管本地。远程仍留着旧分支，新分支默认不会自动创建。必须手动删旧、推新，否则协作时别人拉不到更新。
错误做法：git push origin 新分支名 后就以为完事。结果远程同时存在新旧两个分支，CI/CD 可能继续跑旧分支，PR 指向也容易混乱。
- 先删远程旧分支：
git push origin --delete 旧分支名 - 再推新分支：
git push origin 新分支名 - 最后设置上游跟踪（可选但推荐）：
git branch --set-upstream-to=origin/新分支名 新分支名
git checkout -b + git reset --hard 容易丢提交
有人用 git checkout -b 新分支名 创建新分支，再 git reset --hard 旧分支名 强制移动 HEAD，试图“转移”分支指针。这看似等效，实则危险。
问题在于：reset --hard 会丢弃工作区和暂存区所有未提交变更，且如果旧分支已被删除（比如刚用 -m 改过名），reset 会指向错误 commit，甚至导致提交丢失。
- 这不是重命名，是重建分支，reflog 断层，协作中难以追溯来源
- 如果旧分支有未合并的提交，新分支不会自动继承其 merge base，后续
git merge可能产生意外冲突 -
git branch -m是唯一真正“重命名”的操作，其余都是模拟，别绕远路
重命名本身很简单，难的是同步远程、清理残留、确保团队感知一致。尤其当分支已被他人 tracking 或 CI 配置引用时，光改本地名等于没改。
