golangci-lint默认仅启用govet和errcheck,staticcheck等关键安全检查项完全禁用;必须在.golangci.yml中显式enable: [-staticcheck]并disable过时linter,CI需加--config和--issues-exit-code=1强制生效。

golangci-lint 默认不启用任何安全相关检查项
它装完后只默认开 govet 和 errcheck,而真正能发现资源泄漏、并发陷阱、弃用 API 调用等线上高危问题的 staticcheck 是完全禁用的。你看到的“没报错”,大概率是它根本没在跑 SA1021(循环中滥用 time.After)、SA1019(调用已弃用函数)、SA1006(json.Unmarshal 后忽略 error)这些关键项。
.golangci.yml 必须显式启用 staticcheck 并禁用干扰项
安全类问题集中在 staticcheck,但它的输出会被其他 linter 淹没或冲突,配置必须精简:
- 在
.golangci.yml的enable列表里明确写上- staticcheck,不能依赖默认或父级继承 - 同时
disable掉过时或高误报项:- golint(已归档)、- maligned(功能被staticcheck覆盖)、- scopelint(与staticcheck重叠且维护停滞) - 避免
enable-all: true—— 这会让deadcode、dupl等低价值检查刷屏,反而掩盖 SA 开头的真实风险 - 多 module 项目中,每个子模块的
go.mod同级目录都得有独立的.golangci.yml,根目录配置不会自动生效
CI 中必须加 --config 参数且验证 staticcheck 是否真在运行
本地 golangci-lint run 可能自动读到配置,但 CI 环境(如 GitHub Actions)常因工作目录、缓存或 GOPROXY 缺失导致配置失效,结果就是“扫描了但没扫到安全问题”:
- CI 脚本里必须显式指定:
golangci-lint run --config=.golangci.yml - 加
--issues-exit-code=1强制让含 SA 问题的构建失败,否则静默通过等于没配 - 加
--out-format=tab或临时加--verbose,确认日志里出现staticcheck: running而不是跳过 - 如果用
find . -name "go.mod"批量扫描子模块,每个cd $moddir && golangci-lint run -c .golangci.yml都得单独执行,不能只在根目录 run 一次
GoLand 里 staticcheck 不显示波浪线?路径和配置双校验
IDE 里看不到警告,90% 是路径填错或配置未联动:
立即学习“go语言免费学习笔记(深入)”;
- Settings → Go → Static Analysis → Executable:必须填绝对路径,比如
/home/you/go/bin/golangci-lint,别信“自动检测”或只写命令名 - 勾选 “Use configuration file”,并指向项目根目录的
.golangci.yml—— 否则表格里手动勾的staticcheck会被忽略 - 检查
.golangci.yml里有没有disable-all: true却没在enable:下列任何项,这种配置会让整个检查静默退出 - GoLand 只分析打开的文件,关掉的文件即使有 SA1019 也不会标红;想全局验证,仍需终端跑
golangci-lint run
最容易被忽略的是:staticcheck 的很多规则(比如 SA1021)依赖完整类型信息,如果子模块 go.mod 未被主模块 replace、或 GOPROXY 未设,它会在解析阶段静默跳过,连 warning 都不打。验证方式很简单——在对应模块目录下直接执行 go list -m,输出必须是模块路径,而不是 command-line-arguments。


















