GoLand代码检查需同时满足三条件：正确安装golangci-lint、IDE中External Tools与Go Linter路径一致且为绝对路径、项目含go.mod并正确配置GOROOT和GO111MODULE；否则提示静默失效。
GoLand 的代码检查提示不是“开个开关”就完事的，它依赖三件事：正确安装的 linter 工具、匹配的 IDE 配置项、以及项目上下文（比如 go.mod 是否存在、GOROOT 是否指向当前 Go 版本）。
确认 golangci-lint 已安装并可被识别
GoLand 本身不内置 linter，它靠调用外部工具（如 golangci-lint）来提供检查结果。如果提示空白或只有基础语法高亮，第一步就是验证工具链：
- 终端执行
which golangci-lint（macOS/Linux）或where golangci-lint（Windows），确保返回有效路径 - 若未安装，运行：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2（版本号建议查官网最新稳定版） - 在 GoLand 中打开
Settings → Tools → External Tools，手动添加一条：
• Name:golangci-lint
• Program: 填入上一步得到的完整路径（如/Users/xxx/go/bin/golangci-lint）
• Arguments:run --out-format=colored-line-number --timeout=2m $FileDir$
启用内置 Go 检查并排除干扰项
GoLand 自带一组轻量级 Go inspections（不依赖外部工具），但默认可能未全开，且容易和 golangci-lint 冲突导致重复警告：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入
Settings → Editor → Inspections，搜索go，勾选你关心的项，例如：Unused parameter、Unreachable code、Shadowing of local variable - **关键动作**：取消勾选所有标有 “
golangci-lint” 或 “external” 字样的 inspection —— 它们只是代理，实际由外部工具执行，留着会重复报错 - 若项目含大量生成代码（如
pb.go或mock_*.go），在Inspections → Go → Go Linter下设置Exclude paths，填入**/generated/**,**/mocks/**
让问题实时显示在编辑器里而不是只靠右键触发
很多人配置完只能右键调用 External Tools 看结果，这是没激活实时检查。要让它像 JS/TS 那样波浪线提示，必须走 GoLand 的 “Go Linter” 集成路径：
- 确保项目根目录下有
go.mod，且 GoLand 是以该目录为工作区打开的（不是只打开单个 .go 文件） - 进入
Settings → Languages & Frameworks → Go → Go Linter
• 勾选Enable go linter
• Tool: 选择golangci-lint（不是go vet或空）
• Path: 必须填与上一步 External Tools 一致的完整路径
• Arguments: 推荐用--fast（跳过耗时检查） +--issues-exit-code=0（避免误中断编辑） - 重启 GoLand，打开任意
.go文件，写一行明显有问题的代码（如var x int; _ = x），看是否立刻出现黄色波浪线
常见失效原因和绕不过去的坑
即使上述都做了，提示仍不出现，大概率卡在这几个地方：
-
GOROOT不一致：GoLand 的Settings → Go → GOROOT必须和终端go env GOROOT输出完全相同；用 asdf/gvm 管理 Go 版本时尤其容易错配 -
GO111MODULE=off：如果终端或 GoLand 内置终端里这个环境变量是 off，golangci-lint会找不到模块依赖，直接静默失败 —— 检查并设为on或删掉该变量 - 缓存未刷新：修改
.golangci.yml后，GoLand 不会自动重载；必须手动触发File → Reload project from disk，或点击右下角 “Reload project” 提示 - 并发超时：大型项目首次运行可能卡住，
.golangci.yml中加timeout: 3m和concurrency: 2更稳妥
最常被忽略的是：**GoLand 的 Go Linter 面板里填的 Path 必须是绝对路径，且不能带空格或中文；哪怕只差一个字符，它也不会报错，而是彻底静默——你得靠 golangci-lint run 命令行先验证通不通。**
