1. 概述
Git 是目前业界广泛使用的版本控制系统。在日常开发中，我们通常会在不同的分支上进行开发、合并、发布等操作。
有时候我们需要在脚本中获取当前所在的 Git 分支名称，而不是手动查看。本文将介绍几种在 Git 中获取当前分支名称的方法，并对比它们的适用场景。
2. 问题背景
我们先来看一个 Git 仓库 myRepo 的分支情况：
$ git branch -a
* feature
master
remotes/origin/HEAD -> origin/master
remotes/origin/master
从输出可以看出，当前我们处于 feature 分支（前面有 * 标记）。
如果我们想在 CI/CD 脚本、自动化工具或部署脚本中获取当前分支名，显然手动查找不合适。我们需要一个命令可以直接输出当前分支名称，例如只输出 feature。
接下来我们就介绍几种常用的方法。
3. 使用 git symbolic-ref 命令 ✅推荐
当前分支信息通常保存在 .git/HEAD 文件中，它指向当前分支的引用路径：
$ cat .git/HEAD
ref: refs/heads/feature
我们可以使用 git symbolic-ref 命令来读取这个符号引用，并用 --short 参数来简化输出：
$ git symbolic-ref --short HEAD
feature
这个方法兼容性好，适合大多数 Git 版本使用。
4. 使用 git rev-parse 命令 ✅推荐
从 Git 1.7 开始，可以使用 git rev-parse 命令来解析当前分支：
$ git rev-parse --abbrev-ref HEAD
feature
这个命令也十分稳定，常用于脚本中获取当前分支名。
5. 使用 git name-rev 命令 ⚠️注意
git name-rev 可以将提交对象（rev）转换为可读的分支名，使用 --name-only 可以只输出分支名：
$ git name-rev --name-only HEAD
feature
这个方法在某些场景下可能返回 tags 或 remotes 名称，不如前两种方法可靠，不推荐用于生产脚本。
6. 使用 git branch 命令 ❌不推荐
默认执行 git branch 会列出所有本地分支，并在当前分支前加 *：
$ git branch
* feature
master
我们可以通过 sed 提取当前分支名称：
$ git branch | sed -n '1{s/^* *//;p}'
feature
虽然可以实现，但需要依赖外部命令 sed，不够优雅。
✅ 从 Git 2.22 开始，可以直接使用：
$ git branch --show-current
feature
这是 git branch 的原生支持，推荐使用此方式替代之前的文本处理方式。
7. 总结
| 方法 | 命令 | 推荐程度 | 说明 |
|---|---|---|---|
git symbolic-ref |
git symbolic-ref --short HEAD |
✅✅✅ | 稳定、兼容性好 |
git rev-parse |
git rev-parse --abbrev-ref HEAD |
✅✅✅ | 常用于脚本，推荐 |
git name-rev |
git name-rev --name-only HEAD |
⚠️ | 可能返回非分支名，慎用 |
git branch + sed |
git branch | sed ... |
❌ | 不推荐，依赖外部命令 |
git branch --show-current |
git branch --show-current |
✅✅ | Git 2.22+ 原生支持 |
在日常开发或自动化脚本中，推荐优先使用 git symbolic-ref 或 git rev-parse，它们兼容性强，输出稳定。
如果你使用的是 Git 2.22 或更高版本，也可以直接使用 --show-current 参数来获取当前分支名，简洁又高效。