直接运行 git branch -m new-name 即可安全重命名当前分支，git 会校验新名合法性（不能以-开头、不含空格、不与现有分支同名），非法则报错，不静默覆盖。

git branch -m 是唯一安全、原子的本地分支重命名方式，其他任何模拟操作（如 git checkout -b + git reset --hard）都可能丢提交、破坏 reflog 或误删工作区变更。

当前就在目标分支上，怎么安全重命名？

直接运行 git branch -m new-name 即可。Git 会校验新名合法性：不能以 - 开头、不能含空格、不能与现有本地分支同名；不合法就报错，不会静默覆盖。

常见错误：

• 当前在 main，却执行 git branch -m feature/login feature/auth —— 这实际把 main 改成了 feature/auth，原 feature/login 完全没动
• 新名含 . 或 ~（如 hotfix.1.2），必须加引号：git branch -m "hotfix.1.2" "fix/1.2"
• Windows 下大小写不敏感，git branch -m main Main 可能无反应，需确认无歧义后加 --force

不在目标分支上，怎么改其他分支名？

必须用两参数形式：git branch -m old-name new-name。这不是“远程操作”，而是原子性地删旧指针、建新指针。

关键注意点：

• old-name 必须拼写完全准确（区分大小写、斜杠），输错会导致 Git 新建一个同名分支，而原分支仍在
• 不能对远程跟踪分支操作，例如 origin/main 不是本地分支，git branch -m origin/main new 会报 fatal: Branch 'origin/main' not found
• 若 new-name 已存在，Git 报 fatal: A branch named 'xxx' already exists.，解决方式只有先 git branch -D new-name（确认无未合并提交后再删）

重命名后 git status 提示 “upstream is gone” 怎么办？

这是正常现象，因为 git branch -m 不动 branch.<name>.merge</name> 和 branch.<name>.remote</name> 配置项，上游记录仍指向 origin/old-name。

Git Worktree

Git Worktree 多需求并行开发助手：在当前 worktree 目录独立开发、修改、提交代码，不跨目录。基于目录命名规范自动识别仓库归属（如 main-repo-feature‑a → main‑repo 仓库）。遵循最小改动原则，从需求分析到 commit 交付全流程负责。触发场景：用户在 ...

下载

必须手动修复上游跟踪，分三步：

• 删远程旧分支：git push origin --delete old-name（别用 git push origin :old-name，CI 工具易解析失败）
• 推新分支：git push origin new-name
• 设上游：git branch --set-upstream-to=origin/new-name new-name（或一步到位：git push -u origin new-name，前提是远程已存在 new-name）

漏掉任意一步，git pull、git push 默认仍找 origin/old-name，CI/CD 也可能继续跑旧分支。

为什么不能跳过远程同步，只改本地名？

远程分支不会自动感知变化，更不会自动删除或重定向。如果只执行 git branch -m 就结束：

• 远程仓库里 old-name 和 new-name 同时存在，PR 关联、权限策略、CI 触发规则全部混乱
• 协作者 git fetch 后仍保留 origin/old-name 跟踪，且不会自动清理；他们必须手动执行 git branch -r -d origin/old-name 才能更新本地远程追踪信息
• VS Code、JetBrains 等 IDE 缓存分支名和上游配置，重命名后推送目标可能仍是旧分支，需手动刷新或重启项目

真正容易被忽略的是：重命名后，其他协作者不会自动感知变化——这从来不是 Git 的能力边界，而是协作流程中必须人工介入的环节。