golangci-lint run无输出是因配置未生效,须检查三点:配置文件名必须为.golangci.yml、与go.mod同目录(monorepo中各module单独配置)、缩进仅用空格;CI中需显式指定--config=.golangci.yml。

golangci-lint run没输出,但CI里一堆报错
这不是工具失效,是配置根本没被读到。三处必查:
• 配置文件名必须是 .golangci.yml(不是 .golangci.yaml 或 golangci.yml)
• 文件必须放在 go.mod 所在目录(monorepo 中每个 module 各自一份,不是 Git 根目录)
• 缩进只能用空格,不能用 Tab;linters-settings 和 run 是顶层字段,不是 linters 的子项
CI 脚本里别依赖自动发现,显式传参:golangci-lint run --config=.golangci.yml
报 SA1019、GO1012 等 staticcheck 错误,本地却看不到
因为 staticcheck 默认是关闭的。golangci-lint 默认只启用约 10 个基础 linter(如 govet、errcheck),像 staticcheck 这种能捕获 time.Now().Unix() > 0 恒真判断的检查器,必须手动启用:
• 在 .golangci.yml 中加到 linters.enable 列表里
• 或设 linters-settings.staticcheck.enable-all: true
同理,goconst(揪出重复 HTTP 状态码字面量)、gosimple(提示简化 if 返回逻辑)也都需显式开启
大量 unused、deadcode、structcheck 报错,新手直接劝退
这些不是初学阶段该优先处理的问题:
• unused 会报未导出但未调用的函数,新手代码常有临时调试函数
• deadcode 对小项目噪声极大,模块未拆分前几乎必报
• structcheck 检查未使用的 struct 字段,但新手连字段生命周期都还没理清
正确做法是先禁用:linters.disable: ["unused", "deadcode", "structcheck"],等项目有测试、模块清晰、能稳定运行后再逐步放开
CI 报 undefined: xxx,但本地 go build ./ 正常
90% 是 Go module 环境不一致:
• CI 默认可能关了 GO111MODULE,导致 go list -deps 解析失败,报 package xxx is not in GOROOT
• 强制在 CI 中设 go env -w GO111MODULE=on
• 检查 CI 的 Go 版本是否 ≥ 1.16(module 默认开启的最低版本)
• 确认 go.mod 已提交,且没有 replace 指向本地未同步路径——CI 拉不到,linter 就无法解析依赖
立即学习“go语言免费学习笔记(深入)”;
配置不是一次写完就一劳永逸的事。不同 Go 版本下 linter 行为可能变化,比如staticcheck 在 1.21 和 1.22 对泛型约束的检查粒度就不一样;golint 已归档,但仍有项目残留它的配置,和 revive 规则重叠又误报高——这些细节不盯住,很容易让 lint 反而变成维护负担。


















