Git预接收钩子中oldrev为全零值时diff报错的解决方法

这个场景我太熟悉了！当你在预接收钩子中碰到oldrev是全零SHA的情况，本质上是因为你正在推送一个全新的分支（或是第一次向空仓库提交代码）——这个全零值代表远程仓库里之前完全没有这个分支的记录，Git自然找不到对应的对象，所以会抛出bad object错误。

核心思路 #

当oldrev是全零SHA时，我们需要把它替换成Git内置的空树对象来对比。这个空树的SHA是固定的：4b825dc642cb6eb9a060e54bf8d69288fbee4904，它代表"没有任何文件内容"的初始状态，刚好对应远程仓库在接收新分支前的状态。

具体实现（Bash脚本示例） #

在你的预接收钩子脚本中，先判断oldrev是否为全零值，再根据情况执行不同的diff命令：

#!/bin/bash

# 预接收钩子会逐行读取ref更新，格式为：oldrev newrev refname
while read oldrev newrev refname; do
    # 检查oldrev是否为40位全零SHA（Git的SHA-1是40位，注意位数不要出错）
    if [ "$oldrev" = "0000000000000000000000000000000000000000" ]; then
        # 对比空树和新提交，得到所有新增的文件
        git --no-pager diff --name-only 4b825dc642cb6eb9a060e54bf8d69288fbee4904 "$newrev"
    else
        # 正常对比两个提交的差异文件
        git --no-pager diff --name-only "$oldrev" "$newrev"
    fi
done

补充说明 #

• 为什么用固定的空树SHA？这个值是Git全局内置的，所有Git仓库都会存在这个空树对象，不需要额外创建，可靠性拉满。
• 如果你的脚本需要处理多个分支推送，一定要把判断逻辑放在while read循环内部，因为预接收钩子会为每个更新的ref单独输出一行oldrev newrev refname。
• 如果你只是想获取新分支的所有文件，也可以用git ls-tree --name-only -r "$newrev"，但用空树diff的方式和正常分支更新的输出格式保持一致，更利于后续统一处理。

内容的提问来源于stack exchange，提问作者ArthNRick