应直接用 golangci-lint 集成进 goland，因其规则全面可控，而内置检查漏报多、不支持自定义配置；需手动配置 external tools 并设为保存时触发，再通过 .golangci.yml 裁剪规则、排除干扰文件。

直接用 golangci-lint 集成进 GoLand，别依赖 IDE 自带的检查 —— 它太弱，漏报多，规则不可控。

为什么不能只靠 GoLand 内置检查

GoLand 自带的语法和风格提示（比如 go fmt、go vet）只覆盖基础项，对常见规范问题无感：比如未处理 error、重复 import、函数圈复杂度超标、硬编码字符串、导出函数缺少文档注释等。它不运行 golangci-lint，也不加载你团队定制的 .golangci.yml 规则。

现象举例：if err != nil { return } 后没处理 err，GoLand 不标红；log.Println("debug") 在生产代码里，它也不提醒。

• 内置检查无法禁用/启用具体 linter（如关掉 lll 行长检查，但保留 errcheck）
• 不支持自定义 exclude-rules（比如忽略 _test.go 或 mock_*.go 文件）
• 无法显示 revive 的命名风格建议（如 userID 应为 userID 还是 UserId）

在 GoLand 里正确接入 golangci-lint

不是装个插件就完事 —— 必须手动绑定到 External Tools，并配置为“保存时触发”或“代码分析集成”。

GoLand 2026.1.1

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

下载

• 打开 Settings → Tools → External Tools，点 + 添加新工具
• Program 填 golangci-lint（确保已在 $PATH 中，或写绝对路径如 /usr/local/bin/golangci-lint）
• Arguments 填：run --out-format=code-climate --issues-exit-code=0 -v --timeout=2m（--issues-exit-code=0 是关键，否则报错时 GoLand 会中断分析）
• Working directory 设为 $ProjectFileDir$
• 勾选 Run external tool on 'Code Cleanup' 和 Run external tool on 'Save'（可选）

完成后，在任意 Go 文件中右键 → External Tools → golangci-lint，就能看到实时报错。错误会像原生提示一样出现在编辑器边栏和底部 Problems 工具窗口中。

常见误报与调优要点

golangci-lint 默认开启 20+ linter，很多规则冲突或过度敏感，必须裁剪。

• 别盲目 enable-all：比如 gosimple 和 staticcheck 功能重叠，同时开会导致重复告警
• revive 的 exported 规则默认要求所有导出函数加注释，但测试文件或 main.go 常不需要 —— 在 .golangci.yml 里关掉：revive.rules: [{name: "exported", disabled: true}]
• 生成代码（如 protobuf 生成的 *.pb.go）必须排除：run.skip-dirs: ["gen", "proto"] 或用 skip-files 正则匹配
• 中文字符串误报？strchecker 类工具不在 golangci-lint 默认列表里，需单独加 —— 它不兼容主流 linter 插件链，得另起进程调用

真正起作用的从来不是“有没有 lint”，而是规则是否和团队当前阶段匹配。刚接入时先 --fix 批量修低风险问题（比如 import 排序、空行），再逐步收紧；否则开发会绕过它，或者把配置文件删了了事。