必须开启golangci-lint的“run on the fly”和nil pointer dereference的“enable interprocedural analysis”，否则无法实现实时缺陷拦截；其余配置如import分组、检查范围等均为辅助优化。
golangci-lint 必须设为 Save on the fly
默认启用的“仅手动运行”模式等于没开——它不会在你敲完 if err != nil 就立刻提醒你漏了 return 或 panic。真正的实时拦截，依赖 Settings → Tools → Go Linter 中勾选 Run on the fly，且 Scope 设为 Whole project 或至少 Current file。
常见错误现象：
- 修改代码后无任何提示，直到手动触发 Inspect Code 才报错
- 保存后 import 顺序乱、未使用包仍残留，说明 linter 根本没跑
实操建议：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确保
golangci-lint可执行文件路径正确（通常为$GOPATH/bin/golangci-lint） - 禁用
disable-all: true后，只显式启用govet、errcheck、staticcheck—— 它们抓的是解引用 nil、忽略 error、死代码等 runtime 级风险，不是风格争议 - 避免全开
revive+gosimple：两者对同一处if x == nil可能重复报，干扰判断
nil 解引用检查需开启 interprocedural 分析
GoLand 内置的 Nil pointer dereference 检查默认只做函数内分析（intraprocedural），遇到跨函数传递的指针就失效。比如 foo(&v) → bar(p *T) → p.Field，若 v 为零值，旧版分析完全沉默。
实操建议：
- Settings → Editor → Inspections → Go → Potential Problems →
Nil pointer dereference，勾选下方 Enable interprocedural analysis - 该选项在 2025 年 7 月后版本才稳定支持，确认 GoLand 版本 ≥ 2025.2
- 过程间分析会轻微拖慢 indexing，但对
main包和高频调用链是值得的——它能提前暴露log.Printf("%s", nil)这类崩溃点
File Watchers 顺序错，import 分组就白配
很多人装了 goimports 却发现 import 始终不按标准库 / 第三方 / 本地包三类分组，问题几乎都出在 File Watchers 的执行顺序上：gofmt 必须排在 goimports 之后，否则 gofmt 会把 goimports 刚排好的空行和分组又抹平。
实操建议：
- Settings → Tools → File Watchers，删除所有已有 Go 相关 watcher
- 重新添加两个：先
goimports（触发时机选 On save），再gofmt（同样 On save，但 Order 设为 Aftergoimports） -
goimports需提前安装：go install golang.org/x/tools/cmd/goimports@latest - 如需进一步拆分第三方包（如分离
github.com/和gitlab.com/），启动时加-local github.com/yourorg参数
Inspection 范围别设太宽，否则卡顿明显
Settings → Editor → Inspections → Go 下，把所有检查项全勾上看似“严谨”，实际会导致 indexing 延迟、CPU 占用飙升、右下角进度条常驻。尤其在大型 monorepo 中，Unused parameter 或 Redundant type in variable declaration 这类检查性价比极低。
实操建议：
- 保留核心三项：
Nil pointer dereference、Unreachable code、Shadowing of a builtin name - 关闭
Exported function has no exported doc comment等文档类检查——这类应交由 CI 阶段统一 enforce - 对 vendor 目录或
testdata目录右键 → Mark Directory as → Excluded，避免无谓扫描
golangci-lint 的 on-the-fly 模式，是真正把缺陷拦在保存前的关键开关。其他配置再花哨，这两项没开，实时分析就只是个摆设。
