【Git】第十四节：Git Hooks 本地钩子 —— 自动化检查与智能提交流程的构建

💻第14节：Git Hooks 本地钩子 —— 自动化检查与智能提交流程的构建

👽引言：让 Git 提交更智能、更规范

在日常开发中，我们常常希望在某些关键操作（如提交、推送、合并）之前或之后自动执行一些脚本任务，例如：

• 提交前运行代码格式化工具；
• 在 pre-commit 阶段执行 lint 检查；
• 提交后自动生成文档；
• 推送前进行单元测试验证；
• 或者根据分支名称限制提交权限。

Git 提供了 Hooks（钩子）机制，允许你在 Git 的生命周期事件中插入自定义脚本，从而实现自动化控制和增强团队协作规范。

本节课老曹将带你全面掌握：

✅ Git Hooks 的基本原理与分类
✅ 如何配置 pre-commit、pre-push、post-commit 等常用钩子
✅ 使用 Shell 脚本或 Node.js 脚本编写钩子逻辑
✅ 实战演练完整的 pre-commit linting 流程
✅ 使用 Husky + lint-staged 构建现代前端项目的自动化检查体系
✅ 最佳实践与注意事项
✅ 10大高频面试题（含答案）

---

❓一、什么是 Git Hooks？

1. 基本概念

Git Hooks 是 Git 内置的一种事件驱动机制，允许开发者在 Git 生命周期的关键节点上绑定自定义脚本。

这些脚本位于 .git/hooks/ 目录下，每个文件对应一个 Git 操作阶段，例如：

Hook 文件名 触发时机 pre-commit 提交前（暂存区内容确定后） prepare-commit-msg 提交信息编辑前 commit-msg 提交信息确定后 post-commit 提交完成后 pre-rebase 变基开始前 post-checkout 切换分支或恢复工作树后 pre-push 推送远程仓库前 post-merge 合并完成后

✅ 所有钩子默认是 shell 脚本形式，但也可以使用 Python、Node.js 等语言编写。

---

🚧二、Git Hooks 的分类

1. 客户端钩子（Client-side）

作用于本地开发过程中：

• pre-commit
• prepare-commit-msg
• commit-msg
• post-commit
• pre-rebase
• post-checkout
• post-merge

主要用于：

• 代码检查
• 格式化
• 日志记录
• 分支切换提醒等

2. 服务端钩子（Server-side）

作用于远程仓库服务器（如 GitHub、GitLab），用于控制推送行为：

• pre-receive
• update
• post-receive

常用于：

• 权限校验
• CI/CD 自动部署
• 分支保护策略等

⚠️ 本节聚焦于客户端钩子，服务端钩子将在后续平台章节深入讲解。

---

🐋三、Git Hooks 的使用方式

1. 查看当前可用钩子模板

ls -la .git/hooks/

输出示例：

applypatch-msg.sample post-checkout.samplecommit-msg.sample post-commit.samplepost-merge.sample pre-applypatch.samplepre-commit.sample pre-push.samplepre-rebase.sample prepare-commit-msg.sample

所有以 .sample 结尾的文件是默认提供的模板。

2. 创建自定义钩子

示例：创建 pre-commit 钩子

cd .git/hookscp pre-commit.sample pre-commitchmod +x pre-commitnano pre-commit

添加如下内容（Shell 脚本）：

#!/bin/sh# pre-commit hook: run eslint before commitecho \"Running ESLint...\"npx eslint .if [ $? -ne 0 ]; then echo \"ESLint failed. Commit aborted.\" exit 1fi

保存后退出，此时每次提交都会自动运行 ESLint 检查。

---

📏四、实战演练：基于 Husky + lint-staged 的现代化提交流程

场景描述

你正在开发一个前端项目，希望在每次提交时只对修改的文件进行 lint 和格式化。

✅步骤 1：安装依赖

npm install --save-dev husky lint-staged eslint prettier

✅步骤 2：初始化 Husky

npx husky install

这会创建 .husky/ 目录，并设置 Git hooks 的入口点。

✅步骤 3：添加 pre-commit 钩子

npx husky add .husky/pre-commit \"npx lint-staged\"

✅步骤 4：配置 lint-staged

在 package.json 中添加：

{ \"lint-staged\": { \"*.js\": [\"eslint --fix\", \"prettier --write\"], \"*.css\": [\"stylelint --fix\", \"prettier --write\"] }}

现在每次提交时，只会对即将提交的文件进行 lint 和格式化！

---

🔨五、常见钩子用法详解

✅ pre-commit：提交前检查

• 用途：代码质量检查、格式化、单元测试等
• 示例：

  #!/bin/shnpx eslint .

✅ commit-msg：提交信息校验

• 用途：检查是否符合 Conventional Commits 规范
• 示例（使用 validate-commit-msg）：

  #!/bin/shexec < /dev/ttynode_modules/.bin/validate-commit-msg $1

✅ pre-push：推送前检查

• 用途：确保所有测试通过后再推送
• 示例：

  #!/bin/shnpm testif [ $? -ne 0 ]; then echo \"Tests failed. Push denied.\" exit 1fi

✅ post-checkout：切换分支后自动安装依赖

• 示例：

  #!/bin/shecho \"Switched branch, installing dependencies...\"npm install

---

⚡六、最佳实践与注意事项

✅ 保持钩子轻量高效，避免影响提交速度
✅ 不要将敏感信息写入钩子脚本
✅ 版本控制你的钩子脚本（可借助 Husky 或 git hooks 工具管理）
✅ 为团队统一钩子规则，避免风格不一致
✅ 结合语义化提交规范（Conventional Commits）提升可读性
✅ 定期更新钩子逻辑，适配新工具或流程变化

---

🏈七、10大高频面试题（含答案）

✅ Q1: Git Hooks 是什么？它有哪些常见用途？

答：
Git Hooks 是一种事件驱动机制，用于在 Git 生命周期中插入自定义脚本。常见用途包括：

• 提交前 lint 检查
• 提交信息校验
• 推送前运行测试
• 切换分支自动安装依赖等

---

✅ Q2: Git Hooks 存放在哪里？

答：
位于 .git/hooks/ 目录下，例如 .git/hooks/pre-commit。

---

✅ Q3: 如何启用一个 Git Hook？

答：
复制 .sample 模板文件，去掉 .sample 后缀，并赋予可执行权限：

chmod +x .git/hooks/pre-commit

---

✅ Q4: 如何查看 Git Hook 的执行结果？

答：
提交或推送时，终端会输出钩子脚本的执行日志。失败则中断操作。

---

✅ Q5: Git Hook 是否会被推送到远程仓库？

答：
不会。.git/ 目录不在 Git 版本控制范围内，因此钩子不会随 git push 推送。

---

✅ Q6: 如何在多个开发者之间共享 Git Hook？

答：
可以使用工具如 Husky + lint-staged，将钩子逻辑写入 package.json，并通过 npm 安装触发。

---

✅ Q7: 如何跳过 Git Hook 执行？

答：
使用 --no-verify 参数：

git commit -m \"WIP\" --no-verify

⚠️ 注意：应谨慎使用，防止破坏规范。

---

✅ Q8: Git Hook 支持哪些语言编写？

答：
支持任何可执行脚本语言，如 Shell、Python、Node.js、Ruby 等。

---

✅ Q9: pre-commit 和 post-commit 有什么区别？

答：

Hook 执行时机 可否阻止提交 pre-commit 提交前 ✅ 可以 post-commit 提交完成后 ❌ 不可以

---

✅ Q10: 如何在 Git Hook 中使用 Node.js 脚本？

答：
确保第一行为正确的解释器路径，例如：

#!/usr/bin/env nodeconsole.log(\"Running pre-commit hook...\");

然后赋予可执行权限：

chmod +x .git/hooks/pre-commit

---

📚八、总结

本节课我们系统讲解了 Git Hooks 的核心概念与使用方法：

✅ Git Hooks 的基本原理与分类（客户端 vs 服务端）
✅ 如何配置 pre-commit、commit-msg、pre-push 等常用钩子
✅ 编写 Shell / Node.js 脚本实现自动化检查
✅ 使用 Husky + lint-staged 构建现代化前端提交流程
✅ 实战演练完整的 linting + 格式化流程
✅ 最佳实践与注意事项
✅ 10大高频面试题解析

通过合理使用 Git Hooks，你可以：

• 实现自动化提交检查；
• 统一团队编码规范；
• 提高代码质量和可维护性；
• 构建更加智能、安全的 Git 工作流；

下一讲我们将进入《第15节：GitHub/GitLab 平台使用》，学习如何注册账号、创建项目、使用 Issue 管理和 Pull Request 流程，构建完整的团队协作流程。

---

附录：推荐资源

📘 Git 官方文档 - Git Hooks
🧰 Husky 文档
🧰 lint-staged 文档
📊 [GitHub Actions 自动化流程集成指南]
🎯 下一步建议：尝试为你的开源项目配置 pre-commit 钩子，练习编写简单的 Shell 或 Node.js 脚本，熟悉各种钩子应用场景。下一讲我们将深入讲解 GitHub/GitLab 的使用技巧，敬请期待！