golangci-lint是Go生态主流静态检查工具，需通过官方脚本安装、配置.golangci.yml启用errcheck/staticcheck/govet/unused等核心linter，并确保go.mod可解析、路径精确匹配，才能有效嵌入CI/IDE/pre-commit全流程。
直接用 golangci-lint，别折腾其他工具——它整合了 errcheck、staticcheck、govet 等十多个检查器，配置统一、性能稳、社区维护活跃。
安装 golangci-lint 并确保命令可用
二进制安装最干净，避开 go install 可能引发的 module 污染和版本漂移问题。
- 运行脚本安装（macOS/Linux）：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2 - Windows 用户用 PowerShell 执行：
iwr -uri https://raw.githubusercontent.com/golangci/golangci-lint/master/install.ps1 -outf install.ps1; .\install.ps1 -BinDir $env:GOPATH\bin -Version v1.54.2 - 验证是否生效：
golangci-lint --version，应输出v1.54.2或更高 - 常见失败现象：
command not found: golangci-lint→ 检查$(go env GOPATH)/bin是否在$PATH中；macOS + zsh 用户需确认~/.zshrc里有export PATH="$GOPATH/bin:$PATH"，然后source ~/.zshrc
创建并配置 .golangci.yml 启用关键检查器
不写配置文件时，golangci-lint 默认只启用保守子集，大量隐患（如忽略 error、死代码、空分支）根本不会报。
- 在项目根目录运行
golangci-lint init生成基础模板，再手动编辑 - 必须显式启用以下核心 linter：
errcheck（捕获未处理的error）、staticcheck（语义级问题，如无效类型断言）、govet（Go 自带检查，但默认只开部分项）、unused（未使用函数/变量，go vet不覆盖） - 禁用
golint—— 官方已归档，规则主观、噪音大 -
govet要全开才有效：linters-settings: govet: checks: ["all"]（注意：Go 1.21+ 支持"all"，旧版本需列具体名如["printf", "atomic", "bools"]） - 跳过无关路径：
skip-dirs: ["vendor", "testdata", "mocks"]，避免误报和性能拖累
golangci-lint run 报 cannot find module providing package
这不是 lint 工具坏了，而是它严格按 go.mod 解析依赖 —— 和 go build 一样，要求本地环境已能正常 resolve 所有 import。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 先确保项目下能跑通：
go list -m all或go build ./...，否则 lint 必然失败 - 如果
go.mod里用了replace指向本地路径，确认该路径存在且含有效go.mod - 临时调试可加
--no-config参数绕过配置加载，判断是否是.golangci.yml里某个 linter 触发了额外 import - CI 场景下务必提前执行
go mod download，否则gosec等依赖完整模块树的 linter 会跳过分析
集成到日常开发流程而非只手动跑一次
只在终端敲一次 golangci-lint run 几乎没用，真要起效就得嵌入动作发生的地方。
- VS Code：装 “Go” 扩展后，在设置里设
"go.lintTool": "golangci-lint"，保存即实时高亮 - pre-commit：用
pre-commit工具 hook，commit前自动跑golangci-lint run --fast（注意：--fast会跳unused等耗时检查，仅适合本地快速反馈） - CI：GitHub Actions 示例步骤中加
golangci-lint run --timeout=3m --concurrency=2 --skip-dirs="vendor,third_party"；--concurrency=2是关键，大项目默认并发易 OOM - 路径匹配必须精确：SonarQube 等平台对接时，
sonar.sources=api,service,pkg必须和golangci-lint run实际扫描路径一致，否则显示 “0 files indexed”
真正容易被忽略的是：lint 不是编译器，但它对模块状态的敏感度和编译器一样高；go mod download、GOCACHE 设置、路径排除规则这三件事，90% 的 CI 失败都卡在这儿。
