git-hooks-setup

Git Hooks Setup

一键配置 Git Hooks，标准化团队开发流程。

Overview

自动生成 pre-commit / commit-msg / pre-push hook 配置，包含代码格式化、commit message 校验、敏感信息检查。支持 husky 和原生 git hooks 两种方案。

When to Use

• User wants to set up git hooks
• User mentions pre-commit or commit message conventions
• User wants to automate lint/format checks
• User inputs /git-hooks-setup
• User wants to enforce pre-push checks (tests, lint)
• User wants to prevent pushing broken code
• User wants to standardize team commit message format
• User wants to add secret scanning before commit
• User wants to auto-format code on every commit

When NOT to Use:

• User only wants to view current git hooks configuration
• User wants CI-based checks (no local hooks needed)
• User's project already has a complete hooks setup
• User wants to run hooks on specific files only (use lint-staged directly)
• User wants to hook into Git events other than pre-commit/commit-msg/push

Core Pattern

Step 1: 检测项目环境

# 检测包管理器（按 lock 文件判断）
if [ -f "package-lock.json" ]; then PACKAGE_MANAGER="npm"
elif [ -f "yarn.lock" ]; then PACKAGE_MANAGER="yarn"
elif [ -f "pnpm-lock.yaml" ]; then PACKAGE_MANAGER="pnpm"

# 检测已有 hooks 配置
test -d ".husky" && echo "husky 已配置"
test -f ".git/hooks/pre-commit" && echo "原生 hooks 已配置"

# 从 package.json 检测已安装的 lint 工具（eslint/prettier/lint 相关）

Step 2: 选择方案

方案	适用场景	优点
husky	Node.js 项目	团队协作友好，配置即代码
原生 git hooks	非 Node.js 项目	无依赖

Step 3: 生成配置

方案 A: Husky

# 根据 $PACKAGE_MANAGER 选择: pnpm dlx / yarn dlx / npx
husky init    # 初始化 husky

生成 .husky/pre-commit（执行 lint-staged）和 .husky/commit-msg（执行 commitlint），注意 commitlint 需加 --no 前缀避免交互式安装。

生成 lint-staged 配置（写入 package.json）：

{
  "lint-staged": {
    "*.{ts,tsx,js,jsx}": ["eslint --fix", "prettier --write"],
    "*.{json,md,yml}": ["prettier --write"]
  }
}

生成 .husky/pre-push（可选，push 前跑测试）：

# 根据包管理器选择命令
if [ "$PACKAGE_MANAGER" = "pnpm" ]; then
  pnpm test
elif [ "$PACKAGE_MANAGER" = "yarn" ]; then
  yarn test
else
  npm test
fi