golangci-lint 在 Git commit 前拦截问题需通过 pre-commit 钩子显式接入，推荐使用 Husky + lint-staged 组合，配置 golangci-lint run --new --fast -E errcheck,govet,staticcheck 仅检查暂存文件，并注意 PATH、Go 环境及配置文件路径。
golangci-lint 能在 Git commit 前拦截问题，但默认不生效 —— 必须显式接入 pre-commit 钩子，且不能只靠 golangci-lint run 命令裸跑。
pre-commit 钩子必须调用 golangci-lint run --new-from-rev=HEAD~1
直接在 .git/hooks/pre-commit 里写 golangci-lint run 会检查整个项目，慢、易误报、破坏开发节奏。真正实用的写法是只查本次提交涉及的文件：
- 用
--new-from-rev=HEAD~1限定范围：仅检查即将提交的新增/修改文件（包括 staged 和未 staged 的变更） - 若只想查暂存区（staged）文件，改用
--new（等价于--new-from-rev=origin/main，需确保本地分支已同步） - 加
--fast跳过缓存重建，提速明显，尤其对大项目 - 务必加
-E或--enable显式指定 linters，避免配置文件未加载时静默跳过检查
Husky + lint-staged 组合比原生钩子更可靠
原生 .git/hooks/pre-commit 文件不被 Git 跟踪，克隆仓库后自动丢失，团队协作几乎不可用。Husky 是当前最稳妥的方案：
- 安装：
npm install husky --save-dev，然后npx husky install - 启用钩子：
npx husky add .husky/pre-commit "npx lint-staged" - 在
lint-staged配置中绑定 Go 文件："*.go": ["golangci-lint run --new --fast -E errcheck,govet,staticcheck"] - 注意：
lint-staged默认只传暂存文件路径给命令，golangci-lint必须支持该行为 —— v1.52+ 已兼容，旧版本会报no files to process
常见失败原因：PATH、Go 环境、配置文件缺失
钩子执行失败往往不是工具本身问题，而是环境链断裂：
立即学习“go语言免费学习笔记（深入）”；
-
golangci-lint: command not found：Husky 启动的 shell 可能不读取~/.bashrc，在.husky/pre-commit开头显式补全 PATH，例如：export PATH="$HOME/go/bin:$PATH" - 检查不到
.golangci.yml：确保该文件在项目根目录，且golangci-lint运行时工作目录是 Git 顶层（lint-staged默认满足） - 报
failed to load go module：钩子内没加载 Go 环境变量，加export GOPROXY=https://proxy.golang.org,direct - CI 中通过但本地失败：检查 Go 版本是否一致，
staticcheck等 linter 对 Go 版本敏感
别忽略 git add 的时机问题
如果 golangci-lint 报错后你手动修复了代码，但没重新 git add，下一次 git commit 仍会失败 —— 因为钩子只校验暂存区内容。更麻烦的是，有些团队想让钩子自动 git add 修复后的文件，但 golangci-lint 不提供自动修复能力（它只报错），真正能 auto-fix 的是 goimports -w 或 gofumpt -w。所以：若要自动修复+重暂存，得另配脚本组合，不能只依赖 golangci-lint。
