必须在.golangci.yml中启用revive或gocritic等可插拔linter,并通过独立配置文件(如.revive.toml)或linters-settings子项定义规则;.golangci.yml仅负责启用和路径指向,不可将规则直接写入其中。

怎么在.golangci.yml里加自定义规则
golangci-lint 本身不支持“写新规则”,但能通过 revive 或 gocritic 这类可配置 linter 实现自定义逻辑。关键不是改 golangci-lint,而是选对可插拔的 linter 并配好它的子配置。
必须确保:.golangci.yml 和 go.mod 在同一级目录;revive 或 gocritic 已安装(如 go install github.com/mgechev/revive@latest);且在 linters.enable 中显式启用它。
-
revive用.revive.toml(或 YAML/JSON),支持细粒度开关每条规则,比如禁止下划线前缀导出变量:[rule.exported]+severity = "error" -
gocritic配置在linters-settings.gocritic.enabled-checks下,例如启用"rangeValCopy"检查循环中值拷贝开销 - 别把自定义规则塞进
linters-settings以外的地方——golangci-lint 不会识别 - 如果用了
revive,就别同时开gosimple或staticcheck的同类检查(如导出命名、死代码),否则重复报错
为什么 rev 不能直接写在 .golangci.yml 里
revive 的规则体系和 golangci-lint 的 YAML 结构不兼容:它的规则名、参数层级、默认行为都独立于外层配置。硬塞进去只会被忽略,或触发解析错误 yaml: unmarshal errors。
正确做法是分两层:
- 在
.golangci.yml中只做“启用”和“路径指向”:linters: enable: - revive linters-settings: revive: config: ".revive.toml" - 所有具体规则写在单独的
.revive.toml文件里,放在项目根目录(和.golangci.yml同级) - 运行时 golangci-lint 会把
.revive.toml透传给revive进程,由它自己解析
CI 或 pre-commit 里自定义规则不生效的常见原因
本地跑 golangci-lint run 有自定义告警,但 CI 里完全没反应——大概率是路径或环境断了。
- CI 镜像里没装
revive,只装了golangci-lint;得在 CI 脚本里补一句go install github.com/mgechev/revive@latest -
.revive.toml没提交到 Git,或被.gitignore忽略了 - CI 运行命令漏了
--config=.golangci.yml,导致 fallback 到默认配置(此时revive根本不会被加载) - Go 版本不一致:revive v1.3+ 要求 Go ≥ 1.21,而某些 CI 基础镜像还用着 1.19,会静默跳过该 linter
什么时候该用 gocritic 而不是 revive
两者都能自定义,但定位不同:revive 更偏风格与基础语义(命名、导出、注释),gocritic 专注性能与反模式(比如 flagDeref 检查指针解引用风险、underef 找未解引用的接口断言)。
- 想禁用某条
gocritic规则?写在linters-settings.gocritic.disabled-checks下,不是enabled-checks -
gocritic默认不开任何检查,必须显式列在enabled-checks里才生效,不像revive有默认规则集 - 如果团队在做性能攻坚(比如高频服务内存逃逸分析),
gocritic的rangeValCopy和unnecessaryCopy比revive实用得多
真正麻烦的是规则之间隐性冲突——比如 revive 的 exported 和 staticcheck 的 SA1019 都可能对同一个函数名报错,但提示角度完全不同。调试时得关掉一个再比对输出,而不是堆砌一堆 linter 就以为覆盖全了。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











