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 命令参数详解。