新手必须直接配置golangci-lint而非golint或单独go vet，因golint已于2021年归档、规则主观噪音大；go vet默认漏检unmarshal等高危项；而golangci-lint聚合staticcheck、govet、errcheck等，一条命令覆盖语义、错误处理、资源泄漏三层风险。
别用 golint，也别只跑 go vet 默认检查——golangci-lint 是 Go 新手唯一该配的静态扫描起点。
为什么新手必须跳过 golint 直接上 golangci-lint
golint 已在 2021 年被官方归档，现在装了也会报错或误报；它规则主观（比如强制首字母大写）、不维护、噪音极大。而新手最需要的是：能发现 json.Unmarshal 漏错、err 忽略、死代码、类型断言失败等真实隐患，不是风格争论。
golangci-lint 内置 govet、staticcheck、errcheck 等关键 linter，一条命令就能覆盖语义、错误处理、资源泄漏三层风险。
- 装
golint→ 项目里留着golint配置项 →golangci-lint run直接失败 - 只跑
go vet默认项 →unmarshal、atomic、bools全不检查 → 明明写了json.Unmarshal(b, &v)却没警告 - 手动装
staticcheck单独跑 → 常见报错no Go files in directory→ 八成是没在go.mod根目录，或GO111MODULE=off
新手最小可用配置：三步生成 .golangci.yml
不要从零手写，用官方初始化命令生成基础骨架，再删冗余、开关键项：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在项目根目录（有
go.mod的地方）运行：golangci-lint config init→ 自动生成.golangci.yml - 删掉或禁用
golint：linters.disable: ["golint"]（别留任何golint在enable列表里） - 强制启用
govet全量检查：linters-settings.govet.checks: ["all"]（Go 1.21+ 支持，否则显式列["printf", "shadow", "unmarshal", "atomic"]） - 确保
errcheck和staticcheck在linters.enable列表里
示例片段：
linters-settings:
govet:
checks: ["all"]
errcheck:
check-type-assertions: true
staticcheck:
checks: ["all"]
<p>linters:
enable:</p><ul><li>errcheck</li><li>staticcheck</li><li>govet</li><li>unused</li><li>gosimple常见报错与定位方法：golangci-lint run 没反应 / 不报错 / 报错但不相关
新手最常卡在这三类现象，本质都是路径或配置没生效：
-
command not found: golangci-lint→ 检查$(go env GOPATH)/bin是否在$PATH中；macOS + zsh 用户需确认~/.zshrc含export PATH="$GOPATH/bin:$PATH" - 运行无输出或只报几个无关 warning →
.golangci.yml没被读到，或run.skip-dirs误把.或cmd目录全跳过了 - 写了
if err != nil { return err }却仍被errcheck报 → 检查函数是否返回error类型；errcheck只检查调用点，不分析分支逻辑 -
govet不报unmarshal错 → 确认.golangci.yml里有linters-settings.govet段，且checks显式包含unmarshal或设为["all"]
IDE 实时提示怎么配（VS Code / GoLand）
插件本身不决定检查内容，它只是把本地 golangci-lint 可执行文件和项目根目录下的 .golangci.yml 自动桥接过去。所以重点还是配置文件是否生效：
- VS Code：装好
Go官方插件后，在设置里搜go.lintTool，填golangci-lint；确保工作区打开的是含go.mod和.golangci.yml的根目录 - GoLand / IntelliJ：Settings → Tools → GolangCI-Lint → 指向你本地装好的
golangci-lint二进制路径（如~/go/bin/golangci-lint） - 插件不报错 ≠ 配置生效：右键菜单选 “Run golangci-lint” 手动触发一次，看终端输出是否和命令行一致
真正容易被忽略的是：IDE 插件默认不会自动加载 .golangci.yml 里的 run.skip-dirs 或 issues.exclude，部分插件甚至只读 linters.enable。遇到 IDE 提示和命令行不一致，优先怀疑插件版本旧或配置未热重载。
