git怎么使用钩子脚本

Git钩子脚本终极指南：从入门到精通

目录导读

Git钩子脚本是什么？
Git钩子存放位置与类型
常用Git钩子脚本详解
如何创建与配置钩子脚本
实战案例：自动化部署钩子
Git钩子脚本最佳实践
常见问题与解决方案

什么是Git钩子脚本

Git钩子脚本是Git版本控制系统中的强大功能，它允许开发者在特定的Git操作（如提交、推送、合并等）前后自动执行自定义脚本，这些脚本可以是Shell脚本、Python脚本或其他任何可执行文件，能够自动化执行代码检查、测试运行、部署流程等任务,极大提升开发效率和工作流一致性。

每个Git仓库都包含一个.git/hooks目录，其中存放着各种钩子脚本的示例文件，默认情况下，这些示例文件都以.sample扩展名结尾，需要重命名或创建新文件才能激活，Git钩子分为客户端钩子和服务器端钩子两大类,分别对应本地操作和远程仓库操作。

钩子存放位置与类型

客户端钩子主要在本地仓库操作时触发：

提交工作流钩子：pre-commit、prepare-commit-msg、commit-msg、post-commit
邮件工作流钩子：适用于通过邮件接收补丁的工作流
其他客户端钩子：pre-rebase、post-rewrite、post-checkout、post-merge

服务器端钩子在远程仓库操作时触发：

pre-receive：处理来自客户端的推送操作前执行
update：类似于pre-receive，但为每个推送的分支各执行一次
post-receive：推送完成后执行，常用于通知或部署

钩子脚本的存放位置固定为项目根目录下的.git/hooks文件夹，每个钩子文件必须具有可执行权限,且文件名必须与钩子类型完全一致。

常用Git钩子脚本详解

pre-commit钩子是最常用的钩子之一，在提交操作完成前执行,通常用于：

代码格式检查（如使用Prettier、ESLint）
运行单元测试
检查代码中的调试语句或密码信息
验证提交消息格式

示例pre-commit脚本片段：

#!/bin/bash
# 运行代码检查
npm run lint
if [ $? -ne 0 ]; then
    echo "代码检查失败，请修复错误后再提交"
    exit 1
fi

commit-msg钩子用于验证提交消息格式,确保符合团队规范：

#!/bin/bash
# 检查提交消息格式
commit_msg_file=$1
commit_msg=$(cat "$commit_msg_file")
if ! echo "$commit_msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore): .{10,}"; then
    echo "提交消息格式错误！请使用：类型: 描述"
    echo "feat: 添加用户登录功能"
    exit 1
fi

post-receive钩子常用于自动化部署：

#!/bin/bash
# 服务器端接收推送后自动部署
DEPLOY_DIR="/var/www/ww.jxysys.com"
GIT_DIR="/home/git/repositories/project.git"
while read oldrev newrev refname
do
    branch=$(git rev-parse --symbolic --abbrev-ref $refname)
    if [ "main" == "$branch" ]; then
        # 检出最新代码到部署目录
        git --work-tree=$DEPLOY_DIR --git-dir=$GIT_DIR checkout -f main
        # 重启应用服务
        systemctl restart myapp
        echo "项目已成功部署到ww.jxysys.com"
    fi
done

创建与配置钩子脚本

进入钩子目录

cd /path/to/your/project/.git/hooks

创建钩子脚本文件

# 创建pre-commit钩子
touch pre-commit
chmod +x pre-commit

编辑脚本内容 使用任意文本编辑器编写脚本逻辑,以下是一个综合示例：

#!/bin/bash
echo "正在运行Git钩子检查..."
# 检查是否有未跟踪的文件
untracked_files=$(git status --porcelain | grep "^??" | wc -l)
if [ $untracked_files -gt 5 ]; then
    echo "警告：有超过5个未跟踪的文件，请确认是否需要添加"
fi
# 运行代码质量检查
echo "执行代码质量检查..."
npm run lint:quiet
if [ $? -ne 0 ]; then
    echo "代码检查未通过，提交已终止"
    exit 1
fi
echo "所有检查通过，允许提交"
exit 0

测试钩子 进行相应的Git操作测试钩子是否生效：

git add .
git commit -m "测试钩子功能"

实战案例：自动化部署钩子

实现一个完整的自动化部署流程,当代码推送到主分支时自动部署到服务器：

服务器端post-receive钩子配置：

#!/bin/bash
TARGET="/var/www/ww.jxysys.com"
GIT_DIR="/home/git/ww.jxysys.com.git"
BRANCH="main"
while read oldrev newrev refname
do
    # 只处理主分支推送
    if [[ $refname = refs/heads/$BRANCH ]];
    then
        echo "开始部署到ww.jxysys.com..."
        # 创建临时目录并检出代码
        mkdir -p $TARGET
        git --work-tree=$TARGET --git-dir=$GIT_DIR checkout -f $BRANCH
        # 进入部署目录安装依赖
        cd $TARGET
        npm install --production
        # 运行数据库迁移（如果有）
        if [ -f "database/migrations.js" ]; then
            node database/migrations.js
        fi
        # 重启PM2进程
        pm2 restart all
        # 记录部署日志
        echo "$(date): 成功部署版本 $newrev" >> /var/log/deploy.log
        echo "部署完成！访问 https://ww.jxysys.com"
    fi
done

客户端pre-push钩子增强：

#!/bin/bash
# 推送前运行测试
echo "推送前检查..."
remote="$1"
url="$2"
# 只对特定远程仓库执行检查
if [[ $url =~ "ww.jxysys.com" ]]; then
    current_branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')
    if [ "$current_branch" = "main" ]; then
        echo "正在推送主分支到ww.jxysys.com，运行完整测试..."
        # 运行测试套件
        npm test
        if [ $? -ne 0 ]; then
            echo "测试失败，推送已阻止"
            exit 1
        fi
        # 检查构建是否成功
        npm run build
        if [ $? -ne 0 ]; then
            echo "构建失败，推送已阻止"
            exit 1
        fi
    fi
fi
exit 0

Git钩子脚本最佳实践

版本控制钩子脚本：将钩子脚本存放在项目根目录下的scripts/hooks文件夹中，然后在.git/hooks中创建符号链接,这样钩子脚本就能像其他源代码一样被版本控制。
使用钩子管理工具：对于复杂项目，考虑使用Husky（Node.js项目）或pre-commit（Python项目）等工具管理钩子。
保持钩子轻量快速：钩子脚本应快速执行，避免长时间运行影响开发体验，复杂任务应异步处理或通过CI/CD流程完成。
提供清晰的错误信息：当钩子阻止操作时，应提供明确、可操作的错误信息,帮助开发者快速解决问题。
允许跳过机制：为紧急情况提供跳过钩子的方法：
```
git commit -m "紧急修复" --no-verify
```
团队协作一致性：通过版本控制的钩子脚本确保所有团队成员使用相同的代码检查和质量标准。

常见问题与解决方案

问：钩子脚本不执行怎么办？ 答：首先检查文件权限：chmod +x .git/hooks/钩子名称；其次确认文件名正确（无扩展名）；最后检查脚本开头是否有正确的shebang（如#!/bin/bash）。

问：如何调试钩子脚本？ 答：在脚本中添加调试输出：set -x开启调试模式；或将输出重定向到日志文件：exec > /tmp/git-hook.log 2>&1。

问：服务器钩子如何防止恶意代码？ 答：服务器端钩子应严格验证输入，限制可执行的操作范围，并在受控环境中运行，建议使用专门的Git服务（如Gitea、GitLab）的企业级钩子功能。

问：不同操作系统间的兼容性问题？ 答：避免使用特定平台的命令，使用跨平台脚本语言（Python、Node.js）编写钩子,或提供不同系统的适配脚本。

问：如何管理多个项目的钩子配置？ 答：创建钩子模板库，使用安装脚本同步到各个项目；或使用Git的core.hooksPath配置指向共享钩子目录：

git config --global core.hooksPath ~/.githooks

通过合理使用Git钩子脚本，开发团队可以建立高效、一致的工作流程，自动化繁琐任务，减少人为错误，从而专注于创造性的开发工作，无论是小型项目还是企业级应用,Git钩子都是提升开发效率和代码质量的重要工具。

正文