如何通过Git Hooks确保创建新分支前拉取最新提交？

问题本质 #

当远程分支（如master/development）有新的合并提交后，开发者未拉取远程最新代码就直接基于本地旧分支创建新功能分支，后续推送后会引发远程分支无法快进合并，出现阻塞。

替代Git Hooks的实现方案 #

Git没有直接对应git checkout -b或git branch的内置钩子，但可以通过以下两种方式实现自动同步：

1. 自定义Git别名 #

创建替代原生分支创建命令的别名，在执行分支创建前自动拉取远程最新代码：

# 替代git checkout -b
git config --global alias.checkout-b '!git pull && git checkout -b'

# 替代git branch创建新分支
git config --global alias.branch-new '!git pull && git branch'

使用时直接运行git checkout-b <新分支名>或git branch-new <新分支名>，即可确保先同步当前分支的远程最新代码，再创建新分支。

2. 自定义钩子脚本（进阶） #

借助post-checkout钩子（在git checkout操作后触发，包括创建新分支），添加同步检查或自动拉取逻辑：

#!/bin/bash
# 保存为.git/hooks/post-checkout并赋予执行权限（chmod +x .git/hooks/post-checkout）
if [ "$3" = "1" ]; then
  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
  git fetch origin "$CURRENT_BRANCH"
  LOCAL_HASH=$(git rev-parse "$CURRENT_BRANCH")
  REMOTE_HASH=$(git rev-parse "origin/$CURRENT_BRANCH")
  if [ "$LOCAL_HASH" != "$REMOTE_HASH" ]; then
    echo "⚠️ 本地分支$CURRENT_BRANCH与远程不同步，建议执行git pull后再操作"
    # 可选：自动执行拉取
    # git pull origin "$CURRENT_BRANCH"
  fi
fi

分支模式下的流程规范 #

针对feature->development->master的分支模型，除工具层面解决外，还可从流程上预防：

• 要求开发者每日工作前先拉取development/master的远程最新代码
• 在GitLab开启分支保护：强制合并前分支必须与远程同步，开启"Require branches to be up to date before merging"选项
• 定期清理本地过时分支，避免基于旧分支创建新功能分支

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