pre-receive钩子是否仅服务端生效？本地能否测试该钩子？

1. pre-receive钩子仅在服务端生效 #

是的，pre-receive属于Git服务端钩子，只有当代码推送到远程仓库时，远程服务器上的pre-receive钩子才会被触发执行。本地仓库.git/hooks目录下的pre-receive文件完全不会生效——这就是你修改本地pre-receive后推送无反应的原因。

而你用到的commit-msg是本地钩子，在执行git commit时就会触发，所以修改后能立刻生效检查提交信息。

2. 可以本地测试pre-receive钩子，但需要模拟服务端环境 #

不能直接通过修改本地开发仓库的pre-receive来测试，但可以在本地搭建一个模拟的服务端仓库验证钩子逻辑，步骤如下：

步骤1：创建本地裸仓库（模拟服务端） #

服务端仓库通常是无工作目录的裸仓库，执行命令创建：

mkdir local-server-repo && cd local-server-repo
git init --bare

步骤2：配置pre-receive钩子 #

进入该裸仓库的hooks目录，创建并编辑pre-receive文件：

cd hooks
touch pre-receive

适配服务端的pre-receive钩子示例代码（修正原代码逻辑，服务端钩子输入逻辑和本地commit-msg不同）：

#!/bin/bash
# 定义JIRA工单格式的正则表达式
PATTERN="MM-[0-9]+"

# 读取推送的每个提交引用信息（格式：旧引用 新引用 提交哈希）
while read old_ref new_ref commit_hash; do
    # 获取该提交的第一行信息
    commit_msg=$(git log --format=%B -n 1 "$commit_hash")
    # 检查提交信息是否符合要求
    if [[ ! "$commit_msg" =~ $PATTERN ]]; then
        echo ""
        echo "    ERROR: 提交 $commit_hash 的信息不符合要求"
        echo "    '$commit_msg' 缺少JIRA工单编号（格式示例：MM-1234 修复登录bug）"
        echo "    请修正提交信息后重新推送"
        echo ""
        exit 1
    fi
done

添加执行权限：

chmod +x pre-receive

步骤3：将本地开发仓库指向模拟服务端 #

回到开发仓库目录，添加远程仓库地址：

git remote add local-test-server /path/to/local-server-repo

步骤4：测试钩子 #

尝试推送代码到模拟服务端：

git push local-test-server main

如果提交信息不符合JIRA格式要求，就会触发设置的错误提示，以此验证钩子逻辑是否正常。

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