如何配置Gitolite禁止Fast Forward合并推送？

嘿，这个问题问到点子上了——统一分支策略确实需要强制手段，尤其是当团队用不同工具时，光靠口头约定肯定不够！

核心结论 #

Gitolite本身没有内置的规则直接禁止Fast Forward合并，但我们可以通过自定义服务器端钩子来实现强制检测和拦截，这是最可靠的方案。

具体实现步骤 #

1. 编写pre-receive钩子脚本

这个脚本会在推送前运行，用来验证提交是否符合要求。我们的核心逻辑是：Fast Forward合并不会产生合并提交，而我们要求所有合并必须用--no-ff生成合并提交，所以只要检测目标分支的推送是否包含合并提交即可。

创建一个名为pre-receive的bash脚本，内容如下：

#!/bin/bash

# 替换成你要管控的目标分支，比如main或develop
TARGET_BRANCH="refs/heads/main"

while read old_sha new_sha ref; do
    # 跳过分支删除操作
    if [ "$new_sha" = "0000000000000000000000000000000000000000" ]; then
        continue
    fi

    # 只对目标分支进行检查
    if [ "$ref" != "$TARGET_BRANCH" ]; then
        continue
    fi

    # 跳过新分支创建的情况
    if [ "$old_sha" = "0000000000000000000000000000000000000000" ]; then
        continue
    fi

    # 检查这段提交历史中是否有合并提交
    merge_commits=$(git rev-list --merges "$old_sha..$new_sha")
    if [ -z "$merge_commits" ]; then
        echo "❌ 推送被拒绝：合并到$TARGET_BRANCH必须使用--no-ff生成合并提交，禁止Fast Forward合并。"
        exit 1
    fi
done

exit 0

2. 在Gitolite中配置钩子

• 把脚本复制到Gitolite的hooks/common目录（全局所有仓库生效），或者某个特定仓库的hooks目录（仅该仓库生效）。
• 给脚本添加可执行权限：chmod +x pre-receive。
• 如果是针对单个仓库生效，在gitolite.conf中添加配置：

  repo my-team-repo
      RW+ = @team-members
      config hooks.pre-receive = pre-receive
  

3. 辅助增强：客户端默认配置

为了减少团队成员的操作负担，可以让大家在客户端设置默认合并选项：

# 针对main分支，默认使用--no-ff合并
git config branch.main.mergeoptions --no-ff

但注意这个配置是客户端的，用户可以修改，所以只能作为辅助，服务器端钩子才是强制保障。

测试验证 #

让团队成员做两个测试：

• 尝试用默认的Fast Forward合并feature分支到main，然后推送：会被钩子拦截，收到错误提示。
• 用git merge --no-ff feature合并后推送：可以正常通过。

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