GoLand默认仅启用gopls基础检查，深度规则需golangci-lint；必须配置同级.golangci.yml文件并正确设置File Watchers或External Tools，且文件名严格为.golangci.yml、GOROOT路径正确、gopls≥v0.15.0。

GoLand 默认已开启基础代码检查，但不自动启用 golangci-lint 或其他第三方 linter —— 这是多数人误以为“没检查”的根本原因。

---

golangci-lint 未配置时，GoLand 只做语法和结构级检查

GoLand 内置的 Go 检查（如类型错误、未使用变量、包导入问题）依赖 gopls，只要 GOROOT 和 go.mod 正确，这部分就工作正常。
但像圈复杂度、重复代码、错误处理缺失这类深度规则，gopls 不覆盖，必须靠 golangci-lint 或类似工具。

• gopls 版本需 ≥ v0.15.0（对应 Go ≥ 1.21），否则泛型推断、接口实现提示可能失效
• 若 go.mod 存在但无提示，先检查 Settings → Go → GOROOT 是否指向 which go 返回的路径
• Go Proxy 未配置会导致依赖解析超时，间接让符号索引失败，表现为“跳转失效”“补全空白”

---

在 GoLand 中启用 golangci-lint 实时检查

GoLand 不直接运行 golangci-lint，而是通过 External Tools + File Watchers 或 集成到 Inspections 两种方式接入：

• 推荐用 File Watchers：保存即触发，结果直接标红/黄，双击跳转

  

  GoLand 2026.1.1

  GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

  下载
  • 安装：终端执行 go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
  • 配置：Settings → Tools → File Watchers → “+” → 选择 golangci-lint 模板
  • 关键参数：
    Program: golangci-lint（确保在 PATH）
    Arguments: run --fast --out-format=checkstyle $FilePath$
Output paths to refresh: 留空（Checkstyle 格式由 IDE 自动解析）

• 若偏好手动触发，可用 External Tools：

  • Settings → Tools → External Tools → “+”
  • Name: golangci-lint
  • Program: golangci-lint
  • Arguments: run --fast $FileDir$
  • 右键文件 → External Tools → golangci-lint

注意：--fast 跳过耗时分析（如 goconst、dupl），适合日常；CI 中应去掉该 flag。

---

golangci-lint 配置文件必须存在且被识别

GoLand 仅当项目根目录有 .golangci.yml 或 golangci.yml 时，才将检查结果映射到编辑器内。
常见坑点：

• 文件名必须严格为 .golangci.yml（不是 golangci.yaml 或 config.yml）
• 若使用 revive 等自定义 linter，需在配置中显式启用：linters-settings: revive: rules: [{name: "exported", disabled: true}]
• skip-dirs 和 exclude-rules 写错路径（如漏掉 generated/ 的斜杠）会导致误报堆积
• 修改配置后需重启 GoLand 或手动触发 “Reload project”（右键项目 → Reload project）

---

真正卡住人的地方，往往不是“怎么配”，而是：
golangci-lint 命令能跑通，但 GoLand 里没提示——大概率是配置文件名不对、路径没刷新、或 GOROOT 绑定错版本。
别急着重装插件，先看状态栏右下角是否显示 “gopls ready”，再确认 .golangci.yml 在项目根目录。