Git钩子实现配置文件自动替换：staging仓库需用哪种钩子？

直接给结论：你需要在staging环境检出的本地仓库里配置钩子，推荐优先用post-merge钩子（匹配你的核心拉取场景），如果需要覆盖分支切换场景，可以再配合post-checkout钩子。

为什么选Staging仓库？ #

主仓库是你推送代码的远程仓库（不管是不是裸仓库），而你的需求是当在staging环境执行拉取/分支切换操作后，自动更新本地的config.php。这个操作完全针对staging的工作目录，所以钩子必须放在staging的本地仓库中——Git钩子是仓库级别的，每个本地仓库的钩子独立运行，和远程主仓库没有关联。

钩子类型选择 #

• post-merge：完美匹配你的核心需求——当执行git pull（本质是fetch + merge）完成后，这个钩子会自动触发。它会在代码合并到当前分支后立即运行，刚好适合同步配置文件。
• post-checkout：如果你们有时候会在staging仓库切换分支（git checkout），这个钩子会在分支切换完成后触发，可以同时配置它来覆盖这种场景，确保不管是拉取还是切分支，配置文件都能同步。

具体实现步骤 #

1. 进入staging仓库的根目录：

   cd /path/to/your/staging/repo
   

2. 创建post-merge钩子脚本：
   编辑.git/hooks/post-merge文件（如果文件已存在，注意备份原有内容）：

   #!/bin/bash
   
   # 定义配置文件路径
   CONFIG_SOURCE="config.staging.php"
   CONFIG_TARGET="config.php"
   
   # 检查源配置文件是否存在
   if [ -f "$CONFIG_SOURCE" ]; then
       # 删除旧的config.php（如果存在）
       rm -f "$CONFIG_TARGET"
       # 复制staging配置为正式配置文件
       cp "$CONFIG_SOURCE" "$CONFIG_TARGET"
       echo "[Git Hook] Successfully updated $CONFIG_TARGET from $CONFIG_SOURCE"
   else
       echo "[Git Hook Warning] $CONFIG_SOURCE not found - $CONFIG_TARGET was not updated"
   fi
   

3. 给脚本添加可执行权限：

   chmod +x .git/hooks/post-merge
   

可选：添加post-checkout钩子（覆盖分支切换场景） #

如果需要在切换分支时也自动同步配置，复制上面的脚本内容到.git/hooks/post-checkout，同样执行chmod +x .git/hooks/post-checkout赋予权限即可。

注意事项 #

• 确保config.staging.php在仓库中是被跟踪的（没有被.gitignore排除），这样拉取代码时它会同步到staging仓库，钩子才能找到它。
• 脚本中的路径是相对仓库根目录的，如果你的配置文件不在根目录，需要调整路径（比如./src/config.staging.php）。

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