拉取变更到空仓库时会触发哪个Git hook？

Git不存在专门针对「拉取变更到空仓库」场景的独立钩子，你遇到的post-merge未触发问题是Git的正常设计逻辑，可以通过钩子组合+场景判断的方式覆盖所有需求场景。

问题根因说明 #

你提到的「空仓库首次拉取变更」场景下，git pull会执行快进式检出（fast-forward checkout）而非合并操作，该流程只会触发post-checkout钩子，不会触发post-merge钩子，不属于钩子异常。

具体实现方案 #

建议将文件差异判断、自定义命令执行的核心逻辑抽为独立脚本，同时配置两个钩子调用该脚本，即可覆盖所有场景：

1. 编写核心逻辑脚本 #

创建.git/hooks/run-on-file-change.sh，赋予可执行权限，内容示例：

#!/bin/bash
# 替换为你需要监听的特定文件列表
TARGET_FILES=("deploy.conf" "init.sh")
# 获取变更前后的HEAD哈希，空仓库首次变更时OLD_HEAD为全0
OLD_HEAD=$(git rev-parse HEAD@{1} 2>/dev/null || echo "0000000000000000000000000000000000000000")
NEW_HEAD=$(git rev-parse HEAD)
# 获取两个版本间的变更文件列表
CHANGED_FILES=$(git diff-tree --name-only -r $OLD_HEAD $NEW_HEAD)

for FILE in "${TARGET_FILES[@]}"; do
  if echo "$CHANGED_FILES" | grep -q "^$FILE$"; then
    # 此处替换为文件变更后需要执行的shell命令
    echo "检测到${FILE}变更，执行对应操作"
  fi
done

2. 配置post-checkout钩子 #

编辑.git/hooks/post-checkout，赋予可执行权限，内容示例：

#!/bin/bash
# post-checkout第三个参数为1时表示全量检出（包含克隆、快进拉取、分支切换场景）
if [ "$3" = "1" ]; then
  # 若不需要分支切换场景触发，可添加以下判断过滤：仅克隆/快进拉取场景执行
  # if git reflog show -1 HEAD | grep -qE "(clone:|pull --ff)"; then
    .git/hooks/run-on-file-change.sh
  # fi
fi

3. 配置post-merge钩子 #

编辑.git/hooks/post-merge，赋予可执行权限，内容示例：

#!/bin/bash
.git/hooks/run-on-file-change.sh

该方案可完整覆盖以下所有场景：

• 仓库克隆完成后触发
• 空仓库首次拉取远程变更触发
• 非空仓库拉取非快进式合并触发
• 普通合并操作触发

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