git branch 管理分支指针:列分支、建分支、删分支、改名、看谁合并了谁。注意它不负责切换——切换是 git switch 的工作(Git 2.23 之后职责分开了)。
本文列出 git branch 支持的常用参数,重点讲清理分支时最实用的 --merged 与 -vv。
关于本系列
本文是《Git 使用教程》按命令拆分的第 18 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用
git branch -h 看精简列表、git help branch 看完整手册。示例以 Git 2.56.0 为准。一、命令语法
先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。
bash语法
git branch [<options>] [<branch-name> [<start-point>]]
二、参数逐项详解
下表按用途列出 git branch 的常用参数,每项都注明了「它到底改变了什么」。
| 参数 / 写法 | 作用 |
|---|---|
(无参数) | 列出本地分支,当前分支前带 * |
<名字> [<起点>] | 基于起点(默认 HEAD)新建分支,但不切换过去 |
-a / --all | 同时列出本地与远程跟踪分支 |
-r / --remotes | 只列远程跟踪分支 |
-d / --delete | 删除已合并的分支;未合并会拒绝,防误删 |
-D | 强制删除,等价于 --delete --force |
-m / --move、-M | 重命名分支 / 强制重命名 |
-c / --copy、-C | 复制分支 / 强制复制 |
-v / -vv | 显示每条分支最后一次提交;-vv 额外显示上游跟踪关系 |
--show-current | 只打印当前分支名,脚本里比解析输出更稳(Git 2.22+) |
--merged [<commit>] | 列出已合并进指定提交的分支,清理分支前先跑它 |
--no-merged [<commit>] | 列出尚未合并的分支,删之前必须确认 |
-u <上游> / --set-upstream-to | 给当前分支设置上游;--unset-upstream 取消 |
-f / --force | 强制把已有分支指到别处 |
--sort=<键> | 按 refname、committerdate 等排序 |
--list <模式> | 按通配符过滤分支列表 |
三、常用示例
建分支、看分支
bash建分支、看分支
git branch feature/login # 只建不切
git switch feature/login # 切换
git branch -vv # 看上游跟踪关系
git branch --show-current # 脚本里取当前分支名
安全清理已合并分支
bash安全清理已合并分支
git fetch --prune
git branch --merged main # 这些可以安全删
git branch --no-merged main # 这些还有未合并提交,别删
git branch -d feature/login
改名与重设上游
bash改名与重设上游
git branch -m master main
git branch -u origin/main main
git push -u origin main
四、注意事项
-D 会丢掉未合并的提交: -d 在分支尚未合并时会拒绝,这是保护;-D 跳过检查直接删。真删错了还能用 git reflog 找回哈希并 git switch -c rescue <哈希>。删除远端分支是另一条命令:
git branch -d 只删本地。要删远端用 git push origin --delete <branch>,别人再 git fetch --prune 清理本地残留的远程跟踪分支。五、小结
git branch 的参数里,日常最值钱的是 -a、-vv、--merged、-d 四条。养成「清理前先看 --merged」的习惯,就不用担心手滑删掉还没合并的工作。
本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git switch 命令参数详解。