staticcheck 是检测空指针解引用的核心检查器，需在 .golangci.yml 中显式启用，配合 SA1023、SA5011 等规则，并在 CI 中设 --issues-exit-code=1 才能有效拦截 nil map/切片/接口导致的运行时 panic。
staticcheck 能查空指针，但默认不启用
golangci-lint 默认禁用 staticcheck，而它才是检测空指针解引用（如 nil 切片/映射访问、nil 接口方法调用）的核心检查器。只靠 govet 或 errcheck 完全覆盖不了这类运行时 panic 场景。
常见错误现象：代码里写了 if m != nil { m["key"] = 1 }，但 m 实际是 nil map[string]int，govet 不报，IDE 也没波浪线——因为 staticcheck 没开。
- 必须在
.golangci.yml的linters.enable列表中显式加入- staticcheck - 别信“自动启用”：即使你装了最新版
golangci-lint@latest，只要 YAML 里没写这行，它就不工作 - 确认版本 ≥ v1.57.0：老版本的
staticcheck对泛型空值推导较弱，2026 年推荐用 v1.60+（golangci-lintv2.15+ 自带）
启用 SA 系列规则，尤其是 SA1023 和 SA5011
staticcheck 的空指针相关规则集中在 SA 前缀下，不是所有都默认开；部分需手动放开或调整阈值。
-
SA1023：检测对nil指针/接口的解引用（最常用，开箱即用） -
SA5011：检测nil切片/映射的读写操作（如s[0]、m["k"]），需确保staticcheck启用后自动生效 -
SA4006：检测恒真/恒假空值判断（如if x != nil但x类型根本不可能为nil），有助于清理冗余防御逻辑 - 若想关掉某条（如误报率高的
SA1019），在linters-settings.staticcheck.checks下加- "-SA1019"，不要用disable全局关掉staticcheck
GoLand 里看不到波浪线？路径、配置、作用域三处常断链
即使 .golangci.yml 写对了，GoLand 仍可能不标红——问题往往不在规则本身，而在 IDE 层绑定失效。
立即学习“go语言免费学习笔记（深入）”；
-
Settings → Go → Static Analysis → Executable必须填绝对路径，例如/home/user/go/bin/golangci-lint；填golangci-lint或依赖$PATH会静默失败 - 勾选
Use configuration并指定.golangci.yml路径，否则表格里手动勾的staticcheck会被忽略 - IDE 只分析**当前打开的文件**，未打开的文件不会触发检查——这不是 bug，是设计；CI 中全量扫描才真正反映配置效果
- 检查
.golangci.yml是否与go.mod同级，且文件名严格为.golangci.yml（不是.golangci.yaml或golangci.yml）
CI 中要卡死空指针问题，得设 exit code
本地能看波浪线不等于上线安全。CI 流水线必须让空指针警告变成构建失败，否则没人修。
- CI 脚本里必须加
--issues-exit-code=1，否则staticcheck报错也返回 0，流水线照过 - 别省略
--config=.golangci.yml：某些 CI 环境不自动发现配置，不显式传参就退化到默认集（无staticcheck） - 避免
--fast：该模式跳过所有slow类检查器，而staticcheck默认属于slow分组；微服务项目建议直接去掉--fast - 如果团队接受部分低风险 SA 规则（如
SA1019），可在issues.exclude-rules中按正则屏蔽，但SA1023和SA5011强烈建议保留
空指针问题最麻烦的不是报错位置明显，而是 panic 发生在深层调用栈、日志里只留一行 panic: assignment to entry in nil map。把 staticcheck 配实、配严、配进 CI，才能让这类问题在提交前就浮出水面。
