golangci-lint不是装上就卡质量，需显式配置才能失败：加--issues-exit-code=1使ci中断，--skip-dirs跳过vendor/testdata，--timeout防超时；安装后command not found是因二进制未入path，mac用brew、linux用官方脚本并确保$(go env gopath)/bin在path中。
golangci-lint 不是装上就能卡住质量的，它默认不失败、不跳过 vendor、不设超时，CI 里跑着跑着就绿了，但问题全被当警告忽略。
golangci-lint 安装后 command not found 怎么办
根本原因不是没装好，而是二进制没进 PATH。Mac 用 brew install golangci-lint 最稳；Linux 推荐官方脚本：curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2，但必须确认 $(go env GOPATH)/bin 已加进 shell 的 PATH（比如在 ~/.zshrc 里加 export PATH=$PATH:$(go env GOPATH)/bin）。Windows 用户用 PowerShell 脚本安装后，也要检查 $env:GOPATH\bin 是否在系统环境变量中。
CI 中 golangci-lint run 永远成功，怎么让它真正卡住构建
默认行为是只输出警告，exit code 始终为 0。必须显式加参数才能让 CI 失败：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
--issues-exit-code=1：只要发现任何 issue（包括命名警告），就返回非零码 -
--skip-dirs=vendor,testdata,_test：避免扫描第三方或测试生成代码，减少误报和耗时 -
--timeout=2m：小项目无所谓，但含大量vendor或pb.go文件时，不设 timeout 容易超时失败 -
--fast别在 CI 主流程用——它会跳过unused等耗时 linter，适合 pre-commit 场景
.golangci.yml 里 enable 和 disable 冲突导致规则失效
这两个字段互斥，不能共存。日常推荐用 enable 显式声明，避免继承默认启用的 30+ linter 导致噪音爆炸：
- 基础组合够用：
gofmt、govet、errcheck、staticcheck - 禁用高噪声项：
unused、deadcode、structcheck可先关掉，等代码规模上来再逐步放开 -
staticcheck和gosimple功能重叠，同时开容易重复报同一问题 - 排除路径写在
run.skip-dirs下，别混进linters-settings里
本地能过、CI 报 undefined: xxx 是什么情况
这不是 linter 本身的问题，而是 Go 构建上下文不一致：
- CI 里 Go 版本低于 1.16？补上
go env -w GO111MODULE=on -
go.mod没提交，或里面有replace指向本地未同步路径，CI 拉不到依赖，linter 解析 AST 就失败 - 先验证
go build ./在 CI 里能否通过，再跑golangci-lint run - 不同 Go 版本下
staticcheck对泛型的检查粒度会变，1.21 和 1.22 的结果可能不一致
配置文件提交到仓库只是起点，真正麻烦的是不同 Go 版本、不同 linter 版本之间隐式的兼容性断裂——比如某次升级后 staticcheck 开始报一堆泛型类型推导警告，没人提前知道。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
