Hooks 与事件
输入“/”快速插入内容
Hooks 与事件
Hooks 与事件
用户1208用户12085月29日修改
用时：1 小时 | 难度：⭐⭐ 进阶
目标
自动化系统事件的响应。创建在 Claude Code 操作前后自动运行的脚本。
你将学到
•
Hooks（钩子）的工作原理和触发时机
•
创建提交前验证
•
构建操作后通知
•
编写安全的自动化脚本
•
常见 Hooks 模式
什么是 Hooks？
**Hook（钩子）**是响应某个事件自动运行的脚本。
示例：提交前钩子
提交变更前：
代码块
你执行：git commit -m "Fix bug"
↓
钩子运行：检查版本号一致性
↓
版本号错误时：
❌ 提交被阻止
错误信息说明问题所在
↓
你修复：更新 VERSION 文件
↓
提交成功
Hooks 防止常见错误进入 Git。
Hook 事件
Hooks 可在以下事件触发：
事件 | 时机 | 使用场景 |
工具前钩子（PreToolUse） | Claude 运行工具前 | 验证请求 |
工具后钩子（PostToolUse） | Claude 运行工具后 | 记录结果、检查输出 |
PreCommit | Git 提交前 | 验证变更 |
PostPush | Git 推送后 | 通知团队 |
创建你的第一个 Hook
Hooks 是 .claude/hooks/ 中的 Bash（或 PowerShell）脚本。
基本 Hook 结构
代码块
#!/bin/bash
# Hook: validate-version
# Event: PreCommit
# Description: Check that VERSION file is updated with other changes
# 获取被提交的文件
FILES=$(git diff --cached --name-only)
# 检查 guide/ 下的文件是否被修改
if echo "$FILES" | grep -q "guide/"; then
# 如果 guide/ 有变更，VERSION 也必须有变更
if ! echo "$FILES" | grep -q "VERSION"; then
echo "❌ Error: guide/ was modified but VERSION wasn't updated"
echo "Run: echo '3.x.x' > VERSION"
exit 1 # 阻止提交
fi
fi
exit 0 # 允许提交