1) 把引用解析成 commit SHA#

• 当前 HEAD 指向的提交：

1
git rev-parse HEAD

• 某分支/标签对应的提交：

1
git rev-parse main
2
git rev-parse v1.2.3

• 相对引用：

1
git rev-parse HEAD~1
2
git rev-parse HEAD^

2) 判断是否在 Git 仓库内、拿到 .git 目录#

• 是否在工作树里：

1
git rev-parse --is-inside-work-tree

• .git 目录路径（可能是实际目录或指向 gitdir 的文件解析结果）：

1
git rev-parse --git-dir

• 仓库顶层目录（worktree root）：

1
git rev-parse --show-toplevel

3) 解析引用本身（ref 名称 / 上游等）#

• HEAD 实际指向哪个分支（若是 detached HEAD 会失败或无输出）：

1
git rev-parse --abbrev-ref HEAD

• 当前分支名：

1
git rev-parse --abbrev-ref HEAD

• 当前分支的上游（tracking）：

1
git rev-parse --abbrev-ref --symbolic-full-name @{u}

4) 解析成对象类型（commit/tree/blob/tag）#

• 看某个名字对应的对象类型：

1
git cat-file -t "$(git rev-parse HEAD)"

（rev-parse负责解析出对象 ID，cat-file负责看类型。）

5) 脚本里安全用法#

• 失败时直接退出：

1
git rev-parse --verify HEAD

• 输出短 SHA：

1
git rev-parse --short HEAD

一句话：rev-parse 就是“把你写的 HEAD / main / HEAD~3 / refs/... 等，解析成 Git 内部可操作的确定对象或路径”，脚本里用得非常多。