golang Git Hook自动化实现的示例代码

#!/bin/sh
# .git/hooks/pre-commit
echo "🔍 正在执行代码检查..."
# 1. 格式化检查
gofmt -s -w .
if [ $? -ne 0 ]; then
    echo "❌ gofmt 格式化失败"
    exit 1
fi
# 2. 运行 golangci-lint
golangci-lint run --fast
if [ $? -ne 0 ]; then
    echo "❌ golangci-lint 检查未通过"
    exit 1
fi
# 3. 运行测试
go test -race ./...
if [ $? -ne 0 ]; then
    echo "❌ 测试未通过"
    exit 1
fi
echo "✅ 检查通过，允许提交"

chmod +x .git/hooks/pre-commit

# Go install
go install github.com/evilmartians/lefthook@latest
# 或 Homebrew
brew install lefthook

lefthook install

# lefthook.yml
pre-commit:
  parallel: true           # 并行执行，加速检查
  commands:
    go-fmt:
      glob: "*.go"
      run: gofmt -s -w {staged_files}
    go-vet:
      glob: "*.go"
      run: go vet ./...
    golangci-lint:
      glob: "*.go"
      run: golangci-lint run --fast
    go-test:
      run: go test -race -count=1 ./...
pre-push:
  commands:
    go-test-all:
      run: go test -race -count=1 ./...
    go-build:
      run: go build -o /dev/null ./...
commit-msg:
  commands:
    commitlint:
      run: commitlint --edit {1}

lefthook run pre-commit     # 手动触发 pre-commit
lefthook run pre-push       # 手动触发 pre-push
LEFTHOOK=0 git commit       # 跳过所有 hooks（紧急修复）

pip install pre-commit

# .pre-commit-config.yaml
repos:
  # Go 基础检查
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v5.0.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
      - id: check-added-large-files
        args: ['--maxkb=500']
  # golangci-lint
  - repo: https://github.com/golangci/golangci-lint
    rev: v1.64.0
    hooks:
      - id: golangci-lint
        args: ["--fast"]
  # Go 格式化
  - repo: https://github.com/dnephin/pre-commit-golang
    rev: v0.5.1
    hooks:
      - id: go-fmt
      - id: go-vet
      - id: go-imports
      - id: go-critic
      - id: go-unit-tests

pre-commit install          # 安装 hooks
pre-commit run --all-files  # 手动全量检查
git commit --no-verify      # 跳过 hooks

.PHONY: install test lint pre-commit
install:
	go mod tidy
	go install github.com/brenner8023/simple-pre-commit@latest
	simple-pre-commit        # 自动注入 .git/hooks/pre-commit
test:
	go test -race -v ./...
lint:
	golangci-lint run --fast
pre-commit: lint test       # pre-commit 时执行的检查

.PHONY: setup
setup:
	go mod tidy
	lefthook install          # 或 pre-commit install
	go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

// tools.go
//go:build tools
// +build tools
package tools
import (
    _ "github.com/evilmartians/lefthook"  // go:generate lefthook install
)

go generate ./...

## 开发环境初始化
make setup    # 必须执行，安装 git hooks 和依赖工具