如何获取当前提交的哈希值
获取当前提交哈希:git rev-parse HEAD(SHA-1 为 40 位,SHA-256 为 64 位);短哈希用 git rev-parse --short HEAD。脚本中常用它做版本标记、构建号、镜像标签。
git rev-parse HEAD 输出当前提交的完整对象 ID(SHA-1 仓库为 40 位,SHA-256 为 64 位)。要短哈希(长度受配置和唯一性影响)用 git rev-parse --short HEAD。
用法
git rev-parse HEAD # a1b2c3d4e5f6...(完整)
git rev-parse --short HEAD # a1b2c3d(短哈希)
git log -1 --format=%H # 等价:完整哈希
git log -1 --format=%h # 等价:短哈希
典型用途
# 构建产物打版本标记
VERSION=$(git rev-parse --short HEAD)
docker build -t myapp:$VERSION .
# 在应用里暴露版本端点
COMMIT=$(git rev-parse --verify HEAD^{commit}) || exit 1
printf '{"commit":"%s"}\n' "$COMMIT" > version.json
相关引用
| 引用 | 含义 |
|---|---|
HEAD |
当前提交 |
HEAD^ |
第一个父提交 |
HEAD~3 |
沿第一父链回溯 3 步 |
@{u} |
上游分支指向的提交 |
origin/main |
远程跟踪引用 |
git rev-parse 可以把这些引用全部解析成哈希:git rev-parse HEAD~3。
常见问题(FAQ)
Q:游离 HEAD 状态下拿到什么?
拿到当前检出的那个提交的哈希——detached HEAD 只是 HEAD 直接指向提交而非分支,哈希获取不受影响。
Q:仓库还没有任何提交时会怎样?
报错 "ambiguous argument 'HEAD'"。脚本里用 git rev-parse --verify HEAD^{commit} 2>/dev/null || echo "no commits" 容错。
Q:短哈希会重复吗?
理论上可能,实践中 Git 会按请求或配置的长度生成缩写,必要时延长以在当前仓库中保持唯一。跨仓库交换信息时用完整哈希保险。origin/main 只反映最近 fetch 的本地状态;提交 ID 不包含未提交改动,不能独自代表脏工作区的构建输入。