Git技巧:Git Hook,自动触发,含实战分享

Git技巧:Git Hook,自动触发,含实战分享

最近项目需要1个git合入时触发脚本的功能,使用Git Hook功能实现,总结如下:

Git项目在路径:repo\.git\hooks下有很多文件,这些文件就是本地钩子。

概念

Git Hook(Git 钩子)是 Git 提供的生命周期事件回调机制 ,允许在 Git 操作的关键阶段(如提交、推送、合并等)自动执行自定义脚本(Shell/Python/Node.js 等)。根据作用范围,可分为客户端钩子 (本地开发流程)和服务端钩子(远程仓库权限控制)。以下是最常见的 Git Hook 功能场景及典型用途:

我们可以通过钩子在某一时刻,触发想做的事情,例如:

  1. 提交前检查
  2. 提交信息校验
  3. 推送前验证
  4. 提交后自动化

分类:

  • 客户端钩子:仅在本地仓库触发,用于约束开发者的提交、推送等操作。
  • 服务端钩子:在 Git 服务器(如 GitLab、GitHub)触发,用于全局控制推送行为(如分支保护、自动化部署)。
钩子名称 类型 触发时机 核心作用 示例场景
pre-commit 客户端钩子 git commit 执行时,暂存文件后、提交信息输入前 校验代码质量(格式、语法)、运行预测试,阻止不合格提交 运行 ESLint 检查代码格式,若失败则终止提交。
prepare-commit-msg 客户端钩子 git commit 执行时,提交信息编辑器(如 Vim)打开前 自动生成或修改提交信息模板(如填充任务号、分支名) 从分支名(feature/JIRA-123)提取任务号,自动写入提交信息。
commit-msg 客户端钩子 git commit 执行时,用户输入提交信息后、提交最终确认前 校验提交信息格式(如 Conventional Commits 规范) 强制提交信息以 feat: fix: 等类型开头,否则终止提交。
post-commit 客户端钩子 git commit 提交成功后 提交后的通知或辅助操作(如发送消息、生成文档) 提交后通过 Slack 通知团队新提交的哈希值。
pre-push 客户端钩子 git push 执行前(远程推送前) 检查远程分支状态、运行集成测试,阻止无效推送 推送前运行单元测试,测试失败则终止推送。
post-merge 客户端钩子 git mergegit rebase 合并完成后 合并后的环境修复(如更新依赖、重新构建) 合并后检测到 package-lock.json 变更,自动运行 npm install 安装新依赖。
pre-applypatch 客户端钩子 git am(应用邮箱补丁)或 git apply --apply(应用补丁文件)时,补丁写入工作目录前 补丁应用前的预处理校验(如代码格式、敏感信息检查) 检查补丁内容是否包含 password 等敏感词,若包含则终止补丁应用。
pre-receive 服务端钩子 服务器接收 git push 推送内容前(所有提交被处理前) 全局校验推送内容(如权限、分支保护),阻止非法推送 禁止向 main 分支直接推送(仅允许通过合并请求)。
post-receive 服务端钩子 服务器接收 git push 推送内容后(所有提交已写入仓库) 触发后续操作(如自动部署、生成文档) 推送后自动部署到生产环境(如拉取代码、重启服务)。

注意启用条件 :钩子文件需移除 .sample 后缀(如 pre-commit.samplepre-commit),并通过 chmod +x 钩子名 赋予执行权限。

实战

在项目路径下执行 git init 创建Git库

创建测试文件 demo.py

python 复制代码
def func_a():
    print("Hello A")  # 修改此行(触发行号变化)

def func_b():
    print("Hello B")  # 新增此行(触发行号变化)

钩子文件内容(.git/hooks/pre-commit)

其中需要触发的test.py脚本放在SCRIPT_PATH="F:/my-project/test.py"

内容只需要简单打印,进行测试即可

bash 复制代码
#!/bin/sh
# 适用于 Windows Git Bash 环境的 pre-commit 钩子

# 设置 Python 解释器路径(若 Python 已加入系统 PATH,可直接用 python)
PYTHON_EXE="python"  # 或完整路径(如 C:\\Python39\\python.exe)

# 目标脚本路径(Windows 路径需用正斜杠或双反斜杠)
SCRIPT_PATH="F:/my-project/test.py"  # 或 F:\\my-project\\test.py

# 执行脚本并捕获退出码
"$PYTHON_EXE" "$SCRIPT_PATH"
EXIT_CODE=$?

# 若脚本执行失败(非零退出码),终止 commit
if [ $EXIT_CODE -ne 0 ]; then
    echo "❌ pre-commit 钩子执行失败:脚本 $SCRIPT_PATH 退出码 $EXIT_CODE"
    exit 1
fi

# 脚本执行成功,继续 commit
exit 0

可以看到在git commit后,会自动触发对应路径下的python脚本。

现在就动手配置你的第一个钩子,让代码提交与协作体验焕然一新吧!

相关推荐
普郎特18 分钟前
大白话帮你彻底理解 aiohttp 的 ClientSession 与 ClientResponse 对象
爬虫·python
空中湖1 小时前
PyTorch武侠演义 第一卷:初入江湖 第7章:矿洞中的计算禁制
人工智能·pytorch·python
我会冲击波1 小时前
功能分支落后于develop太多,需要把开发分支合并到功能分支吗?
git·intellij idea
Emma歌小白1 小时前
**大数据量(几千万行)划分价格区间(价格段)
python
马哥python说1 小时前
【效率软件】抖音转换工具:主页链接和抖音号一键批量互转
爬虫·python
江山如画,佳人北望2 小时前
pytorch常用函数
人工智能·pytorch·python
这里有鱼汤2 小时前
首个开源金融平台,一站式数据终端 + AI 代理,量化研究者的利器,速来白嫖
后端·python
这里有鱼汤2 小时前
Python量化实战:如何用Python实现查找相似K线,附源码,建议收藏
后端·python
学术小八2 小时前
第六届物联网、人工智能与机械自动化国际学术会议 (IoTAIMA 2025)
运维·人工智能·自动化
小阿鑫2 小时前
使用 Kiro AI IDE 3小时实现全栈应用Admin系统
前端·后端·python·admin·kiro·next admin·fastapi admin