goland报错但代码能运行，需区分编译错误与静态分析警告：右下角无红色波浪线且终端未报build failed，则多为可配置的linter提示（如sa4006、nilness），非必须修复；可通过alt+enter suppress或调整.golangci.yml排除误报。
GoLand 里报错但代码其实能跑，怎么判断该不该修
GoLand 的错误提示分两类：一类是编译器级的硬错误（比如 undefined: xxx），不修复根本 run 不起来；另一类是静态分析警告（比如 SA4006: this value is never used 或 nilness: possible nil pointer dereference），属于 linter 或检查器的推测性提示。关键看右下角状态栏有没有红色波浪线 + 编译失败提示，或者终端是否输出 build failed。没报编译失败，只是编辑器标黄/红，大概率是可配置的检查项，不是必须改。
快速定位并忽略某个误报的检查项
把光标停在被标红/黄的代码行，按 Alt+Enter（macOS 是 ⌥⏎），会弹出上下文操作菜单。如果看到类似 Suppress for statement、Disable inspection 'xxx' 或 Suppress for file 的选项，说明这是 GoLand 自带的 inspection（如 GoUnresolvedReference）或启用了 golangci-lint 等外部工具的规则。选 Suppress for statement 会在当前行上方插入一行 //noinspection GoUnresolvedReference 注释，临时绕过；选 Disable inspection 'xxx' 则全局关掉这项检查。
- 注意：不同检查项的 suppress 注释格式不同，GoLand 会自动补全，别手写错拼写
- golangci-lint 的告警不会响应
Alt+Enter的 suppress，得去.golangci.yml里配exclude-rules - 关闭 inspection 前先确认它是否真有误报——比如
GoImportStatementNotUsed标红 import，可能是你删了使用但忘了删 import，不是误报
让 GoLand 正确识别 vendor 或 replace 路径下的依赖
常见现象：代码里明明 import "github.com/some/pkg" 并且 go mod vendor 过了，GoLand 却标红说 Cannot resolve symbol。本质是 GoLand 没加载 vendor 目录，或 GOPATH/GOMODCACHE 路径没识别对。进 Settings > Go > GOROOT and GOPATH，确保 Use vendored dependencies 打钩；再进 Settings > Go > Build Tags & Vendoring，确认 Vendoring mode 设为 Auto 或 On。如果用了 replace，还要检查 go.mod 是否已由 GoLand 重新加载（右键项目 → Reload project）。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 替换路径未生效时，GoLand 可能仍从
$GOPATH/pkg/mod查源码，导致跳转到旧版本 -
go list -m all能验证当前模块解析是否正确，结果应和 GoLand 的External Libraries列表一致 - 遇到 vendor 下类型无法跳转，试试删掉
~/.cache/JetBrains/GoLand202*/compiled里的缓存再重启
修复真实编译错误：从 GoLand 提示反推 missing import 或 typo
GoLand 报 undefined: http.HandleFunc 这类错，不一定真是漏 import，也可能是：当前文件在 main 包但写了 package http；或 go.mod 里 module 名和 import 路径前缀不一致（比如 module 是 example.com/foo，却 import "example.com/bar"）；或函数名大小写写错（http.handlefunc 小写就报错）。鼠标悬停在标红处，GoLand 通常会显示“Did you mean…?”建议，点进去就能修正。
-
Alt+Enter在 undefined 符号上，常直接给出Add import for 'http'选项，比手动补 import 快 - 如果提示
cannot use xxx (type *T) as type T，八成是值接收者 vs 指针接收者混用，GoLand 不会自动修，得看方法定义 - 修改
go.mod后记得点右上角Load changes，否则 GoLand 还按旧依赖索引，补全和跳转会失效
真正难处理的不是标红本身，而是标红背后反映的模块边界模糊、replace 冲突、或 IDE 缓存与 go command 状态不一致——这些不会立刻报错，但会让 Alt+Enter 失效、跳转乱跳、补全漏项。
