goland 配置 golangci-lint 必须满足三硬条件：可执行路径手动指定、.golangci.yml 显式加载且与 go.mod 同级、staticcheck/unused/gocyclo 等关键 linter 在配置中显式启用，缺一不可。
GoLand 里配 golangci-lint 不是点几下开关就能用的——它必须满足三个硬条件：golangci-lint 可执行文件路径正确、配置文件显式指定且位置合规、关键 linter（如 staticcheck、unused、gocyclo）手动启用。缺一不可，否则 IDE 看似在运行，实际什么也不报。
golangci-lint 可执行路径必须手动确认
GoLand 不会自动发现你装在 $HOME/go/bin/golangci-lint 或通过 brew install golangci-lint 装的二进制。即使命令行能直接敲 golangci-lint version 成功，IDE 仍可能找不到。
- 进
Settings → Go → Static Analysis，看Executable字段是否为空或指向错误路径 - 别信“自动检测”——点击右侧
+→Browse，手动选中你的golangci-lint文件（macOS 常见路径：/opt/homebrew/bin/golangci-lint；Linux：$HOME/go/bin/golangci-lint） - 路径错会导致 IDE 静默跳过检查，问题窗口空空如也，连
govet都不报
.golangci.yml 必须显式加载且放对位置
IDE 不会自动读项目根目录下的 .golangci.yml，哪怕它和 go.mod 在同一层。不显式指定，就等于没配。
- 在
Settings → Go → Static Analysis中勾选Use configuration，并在输入框填绝对路径或相对路径（推荐.golangci.yml） - 文件名必须是
.golangci.yml（不是.golangci.yaml，也不是golangci.yml） - 必须和
go.mod同级；monorepo 多 module 项目，每个go.mod所在目录都得有一份，父目录的配置不继承 - 配置文件里只写
enable: ["gocyclo"]不够——要调阈值，还得加linters-settings块
关键 linter 默认全关，必须一个个开
默认只开 govet 和 errcheck，staticcheck（揪 SA1019 弃用警告）、unused（查未使用函数/变量）、revive（替代 golint 的可配置风格检查）全被关着。不开，就等于放弃 80% 的真实问题。
- 进
Settings → Go → Static Analysis，滚动表格找到对应 linter 行，手动勾选复选框 - 如果启用了配置文件，表格会变灰——此时必须在
.golangci.yml的enable列表里显式写上它们 - 别无脑全开：
revive和gosimple对同一问题可能重复报，干扰判断 - 想改圈复杂度阈值？必须在配置里写：
linters-settings: gocyclo: min-complexity: 8——这个值不是“最低允许”，而是“超过即报”
保存即扫描必须手动打开
默认是“仅手动触发”（比如右键 → Inspect Code），这等于把守门员放在场边。质量拦截得发生在写完保存那一瞬间。
- 进
Settings → Tools → Go Linter，勾选Run on the fly - 不勾这个，编辑器里不会标红，问题窗口也不会实时更新
- 配合
Save Actions插件，可设为“保存时自动格式化 + 自动 lint”，但注意：先格式化再 lint，否则格式化可能引入新 warning - 新手慎用：如果还没跑通测试、没写好 error 处理，
errcheck和staticcheck会刷屏报错，建议等模块稳定后再全开
最常被忽略的一点：golangci-lint 的配置生效与否，跟 GoLand 设置界面里“静态分析器”页面的勾选状态是两套逻辑——配置文件存在且路径正确，但没在 enable 列表里列出来，照样不运行；反之，GUI 勾了但路径或配置文件失效，也白搭。验证方式只有一个：golangci-lint run --config=.golangci.yml 在终端跑通，且 IDE 里问题窗口出现相同告警，才算真正链路打通。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
