golangci-lint 安装后 command not found 需确保二进制在 PATH 中，Mac 用 brew install，Linux 用官方脚本并配置 GOPATH/bin；.golangci.yml 中 enable 与 disable 不可共存，推荐显式 enable；CI 提速需跳过 vendor/testdata、启用缓存及避免 --fast；CI 报 undefined 多因 Go module 未对齐或 go.mod 问题；版本升级后需验证 JSON 输出兼容性。
golangci-lint 安装后运行报 command not found
装完没进 PATH，或者用了非标准安装方式（比如直接下载二进制但没加执行权限）。Mac 上用 Homebrew 装最稳：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 里，否则 golangci-lint 命令永远找不到。
.golangci.yml 配置里 enable 和 disable 冲突了怎么办
两者不能共存——disable 是全局禁用某些 linter，enable 是只启用列出的几个。选一个策略就行。日常推荐用 enable 显式声明，避免隐式继承默认集带来的意外告警。比如项目偏重简洁和可维护性，可以只开：
enable: - gofmt - govet - errcheck - staticcheck。注意
staticcheck 和 gosimple 功能有重叠，同时开可能重复报错。
CI 中跑 golangci-lint run 太慢，怎么提速
默认会检查所有文件，包括 vendor/ 和 testdata/。加 --skip-dirs 或 --skip-files 直接跳过：golangci-lint run --skip-dirs vendor,testdata --timeout=2m。更关键的是启用缓存：在 CI 环境中设 GOLANGCI_LINT_CACHE 指向共享路径（如 /tmp/golangci-cache），并确保同一 commit 不重复跑全量。另外，--fast 模式跳过耗时 linter（如 unused），适合 pre-commit 场景，但别在 CI 主流程里用它。
本地 golangci-lint run 正常，CI 却报一堆 undefined: xxx
大概率是 Go module 模式没对齐：本地开了 GO111MODULE=on，CI 里却用的旧版 Go 或未设环境变量。检查 CI 的 Go 版本是否 ≥ 1.16，并强制开启 module：go env -w GO111MODULE=on。另一个常见原因是 go.mod 没提交，或 replace 指向了本地未同步的路径——CI 拉不到，linter 就解析失败。确认 go build ./... 在 CI 里能过，golangci-lint 才可能正常。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
配置不是一劳永逸的事，真正麻烦的是不同 Go 版本下 linter 行为不一致，比如 staticcheck 在 1.21 和 1.22 对泛型的检查粒度就变了。每次升级 Go 或 golangci-lint，都得跑一遍 --out-format=json 看输出结构有没有变，不然 CI 解析告警的脚本容易崩。
立即学习“go语言免费学习笔记（深入）”；
