golangci-lint规则不生效主因有三：路径错误（需用绝对路径并test验证）、配置冲突（.golangci.yml优先于ide勾选，避免flag互斥）、缓存未更新（需invalidate caches并查event log中“cached hash matches”）。
golangci-lint配置路径错误导致规则不生效
GoLand 的 Static analyzers 页面里，golangci-lint 可执行路径填错是最常见的“规则冲突”假象——它根本没跑起来，自然不会报错也不会标红。IDE 不会弹窗警告，只静默跳过检查。
点 Settings → Go → Static analyzers，右侧有 Test 按钮，必须点一下：成功返回类似 golangci-lint has version 1.57.2 才算路径有效。若报 command not found 或超时，说明路径是错的（比如用了 ~/go/bin/golangci-lint，但 GoLand 不展开 ~）。
- 路径必须是绝对路径，例如
/Users/you/go/bin/golangci-lint（macOS/Linux）或C:\Users\you\go\bin\golangci-lint.exe（Windows） - 终端里能运行
golangci-lint --version，不代表 GoLand 就能访问——它用的是自己的环境变量，不继承 shell 的 PATH - 如果用 asdf/gvm 管理 Go 版本，得确保
golangci-lint是用当前 Go 版本安装的，否则可能因 ABI 不兼容崩溃
自定义 .golangci.yml 和 IDE 默认规则打架
勾选了 Use configuration 但文件里禁用了某个 linter（比如 disable: ["errcheck"]），而 IDE 界面里又手动启用了它，这时以配置文件为准，IDE 的勾选被忽略——你看到的启用状态是“假激活”。
更隐蔽的问题是规则语义冲突：比如 .golangci.yml 把 govet 设为 fast: true，而 IDE 设置里又给 govet 单独加了额外 flag（如 -shadow），最终命令行会拼出两个互斥参数，导致 golangci-lint 启动失败且无日志。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 临时验证方式：取消勾选
Use configuration，让 IDE 回退到纯默认规则集；重启后看 Problems 窗口是否开始滚动 lint 日志 - 想保留自定义配置，先删掉
.golangci.yml里的run或linters-settings块，只留linters开关，避免 flag 冲突 -
Concurrent threads改成1，多线程在某些 linter 组合下会触发竞态，表现为偶发性不扫描
gopls 和 golangci-lint 规则重叠引发误报
gopls 自带基础诊断（比如未使用变量、类型错误），而 golangci-lint 的 unused、typecheck 等 linter 会重复覆盖同一类问题。结果就是同一行被标两次黄，Alt+Enter 出现两套修复建议，甚至互相抵消——比如 gopls 提示“变量未使用”，你按提示删了，golangci-lint 却因上下文缺失报“空分支”。
这不是 bug，是设计使然：gopls 做实时轻量分析，golangci-lint 做全量深度扫描。两者定位不同，强行统一规则只会牺牲一方能力。
- 优先信任
gopls的实时提示（编辑时就出现），它更准、延迟低；把golangci-lint当作提交前守门员，用golangci-lint run --fast手动触发 - 如果非要关闭某项重叠检查，在
.golangci.yml里禁用对应 linter，而不是去改gopls配置——后者会影响所有语言功能（跳转、补全） -
gopls的诊断开关在 Settings → Languages & Frameworks → Go → Language Server，不要动 “Diagnostics” 下的细粒度选项，容易破坏基础功能
缓存损坏导致规则“记忆错乱”
你改了 .golangci.yml，也点了 Reload project，但 IDE 仍按旧规则标错——大概率是索引缓存把旧配置哈希固化了。尤其在频繁切换分支、修改 go.mod 后，golangci-lint 的配置解析结果会被缓存，不再重新读取。
Event Log 里搜 analysis 或 lint，常能看到一行灰字：Skipped loading config: cached hash matches，这就是缓存生效的铁证。
- 最稳做法：File → Invalidate Caches and Restart… → Invalidate and Restart
- 重启后**不要立刻打开项目**，先新建一个
main.go写package main，确认基础语法检查正常，再开原项目 - 如果仍不行，手动删缓存目录：
~/.cache/JetBrains/GoLand<version>/index</version>（Linux/macOS）或%LOCALAPPDATA%\JetBrains\GoLand<version>\index</version>（Windows）
cached hash matches 来定位。
