Git初始提交首次检出时如何触发post-checkout钩子

你用的多分支匹配独立gitignore配置的post-checkout方案，首次检出不生效是两个原因叠加导致的：

• Git默认把钩子存在本地仓库的.git/hooks目录下，这个目录不属于Git版本跟踪范围，首次初始化/克隆仓库时，钩子文件本身还没部署到本地，自然不可能触发。
• 就算钩子提前放对位置，首次检出时Git传给post-checkout的旧提交参数是全0的空提交ID0000000000000000000000000000000000000000，原方案的判断逻辑只覆盖了常规分支切换的新旧提交差异场景，没有兼容空提交的首次检出场景，就算钩子跑了也不会执行gitignore替换逻辑。

按下面步骤调整，就能覆盖首次检出的触发场景：

1. 把钩子纳入版本管理，保证首次操作前钩子已就位 #

不要用默认的.git/hooks路径存钩子，把钩子放到仓库内可被版本跟踪的目录，保证克隆/初始化仓库时钩子能被拉到本地：

• 在仓库根目录新建.githooks文件夹，把post-checkout脚本放到这个目录下，给脚本加可执行权限：chmod +x .githooks/post-checkout
• 执行命令修改Git的钩子读取路径，让Git从你新建的目录加载钩子：git config core.hooksPath .githooks
• 把.githooks目录和配置说明一起提交到仓库，所有使用者克隆完仓库后，只需要先执行一次上面的config命令，后续所有checkout操作都会自动加载对应钩子。如果是本地刚初始化的新仓库，先完成这步配置再做第一次提交、第一次分支切换即可。

2. 修改post-checkout脚本逻辑，兼容首次检出场景 #

打开post-checkout脚本，把原来的触发判断逻辑加上对首次检出空提交的兼容，参考逻辑如下：

#!/bin/sh
OLD_REF=$1
NEW_REF=$2
IS_BRANCH_CHECKOUT=$3

# 首次检出（旧ref为空）或者常规分支切换时，都执行gitignore替换逻辑
if [ "$OLD_REF" = "0000000000000000000000000000000000000000" ] || [ "$OLD_REF" != "$NEW_REF" ]; then
    # 下方保留你原来用的多分支gitignore替换逻辑即可
    # 例：git checkout "$NEW_REF" -- .gitignore
    echo "已加载当前分支匹配的.gitignore配置"
fi

exit 0

3. 存量仓库补触发 #

如果是已经克隆完成、还没执行过checkout操作的存量仓库，配完钩子路径后手动执行一次下面的命令，就能初始化加载当前分支的gitignore配置，后续所有分支切换操作钩子都会自动触发：
./.githooks/post-checkout 0000000000000000000000000000000000000000 $(git rev-parse HEAD) 1

内容的提问来源于stack exchange，提问作者Văn Chiến Trương