编辑“︁Git钩子脚本”︁

= Git钩子脚本 =

'''Git钩子脚本'''（Git Hooks）是Git版本控制系统中的一种自动化机制，允许用户在特定事件（如提交、推送、合并等）发生时触发自定义脚本。这些脚本可以用于执行代码检查、测试运行、通知发送等任务，从而增强工作流程的自动化程度。钩子脚本存储在Git仓库的<code>.git/hooks</code>目录中，默认情况下包含一些示例脚本。

== 钩子类型 ==

Git钩子分为两类：
* '''客户端钩子'''：在本地操作（如提交、合并）时触发。
* '''服务器端钩子'''：在远程仓库操作（如推送）时触发。

以下是一些常见的钩子：

{| class="wikitable"
|-
! 钩子名称 !! 触发时机 !! 类型
|-
| <code>pre-commit</code> || 提交前执行 || 客户端
|-
| <code>post-commit</code> || 提交后执行 || 客户端
|-
| <code>pre-push</code> || 推送前执行 || 客户端
|-
| <code>pre-receive</code> || 服务器接收推送前执行 || 服务器端
|-
| <code>post-receive</code> || 服务器接收推送后执行 || 服务器端
|}

== 工作原理 ==

Git钩子脚本是可执行的Shell、Python或其他脚本文件，放置在<code>.git/hooks</code>目录下。当Git执行相关操作时，会自动检查是否存在对应的钩子脚本，并运行它们。

例如，<code>pre-commit</code>钩子在用户执行<code>git commit</code>时触发。如果该钩子返回非零值，提交会被终止。

== 示例：pre-commit钩子 ==

以下是一个简单的<code>pre-commit</code>钩子脚本，用于检查代码中是否包含调试语句（如<code>console.log</code>）：

<syntaxhighlight lang="bash">
#!/bin/sh

# 检查暂存区文件是否包含console.log
if git diff --cached --name-only | xargs grep -n "console.log"; then
    echo "错误：提交中包含调试语句（console.log）！"
    exit 1
fi
</syntaxhighlight>

'''执行效果：'''
<pre>
$ git commit -m "测试提交"
错误：提交中包含调试语句（console.log）！
</pre>

如果脚本检测到<code>console.log</code>，提交会被阻止。

== 实际应用场景 ==

=== 1. 代码风格检查 ===
使用<code>pre-commit</code>钩子运行代码检查工具（如ESLint、Pylint），确保代码符合团队规范。

=== 2. 测试自动化 ===
在<code>pre-push</code>钩子中运行单元测试，确保推送的代码通过测试。

=== 3. 部署自动化 ===
使用<code>post-receive</code>钩子在服务器上自动拉取最新代码并重启服务。

== 高级用法 ==

=== 使用脚本语言编写钩子 ===
钩子不仅限于Shell脚本，也可以用Python、Ruby等语言编写。例如：

<syntaxhighlight lang="python">
#!/usr/bin/env python3

import sys

def main():
    print("Running pre-commit checks...")
    # 检查逻辑
    sys.exit(0 if checks_passed else 1)

if __name__ == "__main__":
    main()
</syntaxhighlight>

=== 钩子管理工具 ===
手动管理钩子可能繁琐，可以使用工具如：
* '''Husky'''（Node.js项目）
* '''pre-commit'''（Python项目）

== 注意事项 ==

* 钩子脚本必须可执行（<code>chmod +x .git/hooks/pre-commit</code>）。
* 钩子不会随仓库克隆自动分发（除非使用模板或工具管理）。
* 钩子执行失败会终止当前Git操作。

== 总结 ==

Git钩子脚本是强大的自动化工具，能够帮助团队标准化开发流程、提高代码质量。通过合理使用钩子，可以减少人为错误并提升效率。初学者可以从简单的检查脚本开始，逐步探索更复杂的自动化场景。

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git高级操作]]