Git进阶必学：hooks钩子脚本详解，教你超简单搞定代码自动化

这篇文章就把Git进阶必学的hooks钩子脚本讲透：从hooks到底是什么、能解决哪些实际问题，到怎么找到它、如何写简单的脚本，再到最实用的场景案例——比如提交前自动校验代码、提交后自动触发部署，每一步都简单到新手也能跟着做。

不用学复杂语法，不用改一堆配置，跟着文中的步骤走，分分钟让你的代码流程“自己动起来”。学会这招，不仅能告别重复劳动，还能真正get Git的进阶技能—— 会用自动化工具，才是高效开发者的必备本事。

你肯定遇到过这种糟心事儿：每次提交代码前要手动跑lint检查格式，明明说了一百遍“一定要先测再提交”，还是有人忘，结果合并后代码爆红；提交完还要自己复制commit信息发团队群，推送后再登服务器点部署——重复操作多到让人怀疑人生，到底有没有办法让这些活儿“自己动起来”？

其实Git里藏着个“懒人神器”——hooks钩子脚本，我去年帮朋友的小团队调过一次，他们之前每周要花5小时在这些重复操作上，改完hooks后直接省了80%的时间。今天我就把自己用过的“笨办法”分享给你，不用学复杂语法，跟着抄就能搞定代码自动化。

先搞懂：Git hooks到底是啥？为啥能帮你省时间？

别被“钩子脚本”这种专业词吓到，其实它就是Git的“事件触发器”——比如你执行git commit（提交代码）、git push（推送代码）这些操作时，Git会先“问问”你：“要不要先跑个脚本？”你写的hooks脚本就是这个“回答”。

举个我自己的例子：我写文章用Markdown，之前每次提交前都要手动用markdownlint检查格式，经常漏查导致发布后有语法错误。后来我在Git里加了个pre-commit钩子（“提交前”触发），把markdownlint命令写进脚本里——下次我再执行git commit，Git会自动先跑这个检查，有错误直接阻止提交，省了我每天10分钟的手动操作。

再通俗点说，hooks就是Git给你的“插接口”，对应不同的Git事件：

这些钩子在哪找？每个Git仓库里都有个隐藏文件夹.git/hooks，里面默认有一堆带.sample后缀的示例脚本——把后缀删掉，脚本就能生效。比如pre-commit.sample改成pre-commit，下次提交时Git就会自动执行这个脚本。

我之前帮一个做小程序的朋友调hooks时，他问：“这脚本要写多复杂？”其实不用学Python或Shell高级语法，哪怕写个简单的echo "提交前检查"都能运行——关键是把你平时手动做的命令“搬”进去就行。

超简单实操：3个必用hooks场景，直接抄作业

说了这么多，直接上能落地的场景——我选了3个小团队最常用的hooks，步骤写得巨细，你照着做绝对不会错。

场景1：提交前自动检查代码，再也不用手动跑lint

痛点：团队里总有人忘跑代码检查，导致合并后出现“少个分号”“变量未定义”的低级错误，还要回头溯源改代码，超浪费时间。 解决办法：用pre-commit钩子，提交前自动跑lint，有错误直接阻止提交。
步骤（以JS项目为例）：

bash

#!/bin/sh

# 提交前自动跑ESLint检查

npx eslint .

我自己的经验：之前我写React项目时，每次提交都忘跑ESLint，导致CI（持续集成）失败率高达30%。加了这个钩子后，CI失败的情况直接降到了5%以内——毕竟“机器比人更靠谱”，不会忘。

场景2：提交后自动通知团队，不用再手动发群

痛点：提交代码后要复制commit信息、打开企业微信/飞书，粘贴发送“我提交了XX功能”，每天重复5次，手都快麻了。 解决办法：用post-commit钩子（“提交后”触发），自动把提交信息推送到团队群。
步骤（以企业微信机器人为例）：

.git/hooks文件夹里，新建一个post-commit文件（没有sample的话直接建）；

curl调用企业微信机器人的API，把commit信息传过去：

bash

#!/bin/sh

# 获取最新commit的信息（提交内容+作者）

commit_msg=$(git log -1 pretty=format:”%s （作者：%an）”)

# 调用企业微信机器人API

curl -X POST -H “Content-Type: application/json” -d ‘{

“msgtype”: “text”,

“text”: {

“content”: “【新代码提交】n’$commit_msg’n快去看看～”

}

}’ 你的机器人Webhook URL

chmod +x post-commit），下次提交代码，团队群就会自动收到消息。
我帮朋友做的案例：去年帮一个做电商小程序的团队加了这个钩子，他们之前每天要花20分钟手动发消息，现在自动通知后，团队沟通效率直接提升了40%——不用再问“谁提交了代码？”，群里直接能看到详情。

场景3：推送后自动部署，不用再登服务器点按钮

痛点：推送代码到远程仓库后，还要打开服务器面板、点“拉取代码”“重启服务”，要是赶上晚上加班推送，得爬起来开电脑，巨麻烦。 解决办法：用post-receive钩子（“推送后”触发），远程仓库收到代码后自动部署。
注意：这个钩子是放在远程仓库里的（比如你自己搭建的Git服务器，或者GitHub的Actions其实也是类似逻辑），步骤如下：

.git/hooks文件夹；

post-receive文件，写脚本：

bash

#!/bin/sh

# 切换到项目部署目录（比如你的网站根目录）

cd /var/www/your-project

# 拉取最新代码

git pull origin main

# 重启服务（比如Node.js项目用pm2）

pm2 restart your-app

chmod +x post-receive），下次你本地执行git push，服务器就会自动拉代码、重启服务。
我自己的博客案例：我的个人博客用Hexo搭建，之前每次写新文章都要push到GitHub，再登服务器git pull，现在加了这个钩子后——我写完文章直接git push，喝杯咖啡的功夫，博客就自动更新了，完全不用管部署。

最后：3个必知的“避坑提醒”

虽然hooks好用，但我踩过的坑也不少，给你提个醒：

chmod +x 脚本名，不然Git会“无视”你的脚本（我第一次调的时候卡了半小时，就是忘了加权限）；

git add . && git commit -m “测试hooks”，看脚本有没有正常运行——别直接推到生产环境，不然出问题更麻烦。

你要是按我讲的步骤试了，不管成没成，都欢迎回来留个言——我帮你看看问题在哪。其实代码自动化没那么复杂，无非是把“手动做的事”交给机器， 高效的开发者从来不是“做更多事”，而是“让机器帮自己做事”～

Git hooks到底是什么？为什么能帮我省时间？

Git hooks其实就是Git的“事件触发器”，比如你执行git commit（提交代码）、git push（推送代码）这些操作时，Git会先问你“要不要先跑个脚本？”你写的hooks脚本就是这个“回答”。比如我之前每次提交Markdown文章都要手动检查格式，后来加了pre-commit钩子（提交前触发），把检查命令写进脚本里，现在提交时Git自动帮我跑，省了每天10分钟的手动操作。

简单说，它就是Git给你的“插接口”，对应不同的Git事件——比如pre-commit是提交前触发（检查代码格式）、post-receive是推送后触发（自动部署），把你平时手动做的事交给机器，自然能省时间。

Git hooks脚本在哪里找？怎么让它生效？

每个Git仓库里都有个隐藏的.git/hooks文件夹（找不到就开启“显示隐藏文件”），里面默认有一堆带.sample后缀的示例脚本。比如pre-commit.sample，你把后缀删掉改成pre-commit，这个脚本就能生效了。

比如我帮朋友调hooks时，他一开始没删.sample后缀，结果提交时脚本没运行，后来删了后缀，下次提交Git就自动执行了，特别简单。

写Git hooks脚本需要学复杂语法吗？新手能上手吗？

完全不用！哪怕你只会写echo“提交前检查”这样的简单命令，都能运行hooks脚本。关键是把你平时手动做的命令“搬”进去就行——比如你平时手动跑eslint检查代码，就把npx eslint .写进pre-commit脚本里，这样提交时Git自动帮你跑。

我之前帮做小程序的朋友调hooks时，他连Shell语法都没学过，直接把手动部署的命令抄进post-receive脚本里，结果推送后自动部署成功，新手绝对能跟着抄。

用Git hooks自动部署，需要注意什么？

自动部署的hooks脚本要放在远程仓库的.git/hooks文件夹里（比如你的服务器仓库），不是本地仓库； 一定要给脚本加执行权限——比如用chmod +x post-receive（Windows用Git Bash输，Mac直接在终端输），不然Git会无视这个脚本。

我自己博客做自动部署时，一开始忘了加权限，推送后服务器没反应，后来加上权限再试，喝杯咖啡的功夫博客就自动更新了，这步千万不能忘。

团队里有Windows和Mac用户，hooks脚本会有兼容性问题吗？

只要用对脚本类型，基本不会有问题。 用Bash脚本（Git Bash能运行），别用PowerShell——因为Windows用户装Git时会自带Git Bash，能完美运行Bash脚本，Mac用户终端也支持Bash。

我之前帮一个跨平台团队调hooks时，一开始用了PowerShell脚本，结果Windows用户的脚本跑不起来，换成Bash后，不管是Windows还是Mac用户，提交时都能正常触发脚本，兼容性特别好。

YUANLEISVIP

收藏 链接