pre-commit 中 go install 安装的 hook 不生效，主因是其独立 shell 环境未加载 $HOME/go/bin；需将该路径加入系统 PATH 或在配置中用 local hook 显式指定绝对路径。
pre-commit 用 go install 安装的 hook 不生效
常见现象是 git commit 时完全没触发检查，或者报错 command not found: golangci-lint —— 这不是 hook 配置错了，而是 pre-commit 的执行环境没加载你的 Go 工具链。
pre-commit 默认用独立的 shell 环境运行，不读取 ~/.bashrc 或 ~/.zshrc，所以 $PATH 里没有 go install 生成的二进制（默认在 $HOME/go/bin）。
- 把
$HOME/go/bin加进系统级 PATH（如修改/etc/environment），或 - 在
.pre-commit-config.yaml里显式指定工具路径：repos:<br>- repo: https://github.com/golangci/golangci-lint<br> rev: v1.54.2<br> hooks:<br> - id: golangci-lint<br> args: [--fast]
然后确保本地已运行go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.54.2，且golangci-lint命令在 shell 中可直接调用； - 更稳妥的做法：用
local类型 hook 直接调用绝对路径：- id: golangci-lint-local<br> name: golangci-lint (local)<br> entry: $HOME/go/bin/golangci-lint<br> language: system<br> types: [go]
go mod tidy 检查该不该放进 pre-commit
它能自动修复 go.mod 和 go.sum 不一致，但放 pre-commit 有副作用：每次提交都改文件，容易引发“无意义变更”或和 IDE 自动 tidy 冲突。
真正需要的是「有人动了 import 却忘了 tidy」时拦截，而不是每次都强制执行。
立即学习“go语言免费学习笔记（深入）”；
- 推荐只在 CI 中跑
go mod tidy -check，失败即拒收； - 如果坚持本地检查，用
localhook + 自定义脚本判断是否改动了*.go文件再决定是否检查：#!/bin/sh<br>if git status --porcelain | grep '\.go$' >/dev/null; then<br> go mod tidy -check && exit 0 || exit 1<br>fi
- 注意
go mod tidy会写磁盘，pre-commit 默认不允许 hook 修改暂存区外的文件，要加always_run: true和pass_filenames: false才安全。
Go test 跑得太慢，怎么控制 pre-commit 里的执行粒度
全量 go test ./... 在 pre-commit 里基本不可行——几十秒起步，开发者会直接 --no-verify 绕过。
关键是缩小范围：只测当前改动的包，而非整个项目。
- 用
git diff --name-only HEAD -- '*.go'提取修改的 .go 文件，再用go list -e -f '{{.ImportPath}}' $(dirname $file)推导出对应包路径； - pre-commit 的
files:正则只能过滤路径，不能动态算包名，所以得写script类型 hook； - 简单够用的方案：
- id: go-test-changed<br> name: go test changed packages<br> entry: ./scripts/precommit-go-test.sh<br> language: script<br> types: [go]<br> pass_filenames: false
脚本里用git diff --cached找出改动的包，逐个go test -short； - 别加
-race或-cover，它们显著拖慢速度，留给 CI 做。
Windows 下 pre-commit + Go hook 报错 exec format error
典型错误信息：fork/exec /home/xxx/.cache/pre-commit/repo.../golangci-lint: exec format error，本质是 Windows WSL 或 Git for Windows 的二进制兼容问题。
根本原因是：pre-commit 在 Windows 上默认用 Git Bash（mintty）环境，而 go install 生成的是 Windows 原生 .exe，但某些 pre-commit 版本会误判为 Linux 二进制。
- 确认
golangci-lint是从github.com/golangci/golangci-lint/cmd/golangci-lint安装的 Windows 版（后缀带.exe），不是手动下载的 Linux 二进制； - 在
.pre-commit-config.yaml中给 hook 加language_version: system，避免 pre-commit 尝试自己管理 Go 环境； - 更省事的解法：改用
docker类型 hook，镜像用golang:1.22-alpine，彻底绕过宿主环境差异。
复杂点在于：pre-commit 的 hook 生命周期和 Go 工具链版本耦合很紧，rev 锁死、go install 路径、shell 环境隔离这三者稍有不匹配，就会静默失效。别指望一次配好，得对着 pre-commit run -v 的输出逐行看执行路径。
