先检查goroot和gopath配置：goroot须指向go安装根目录（如/usr/local/go），非bin子目录；若项目含go.mod，则gopath可留空，否则需与终端echo $gopath一致；右键项目根目录reload project强制重载依赖。
GoLand 里代码爆红但实际能编译运行？先检查 GOPATH 和 Go SDK 配置
GoLand 不是单纯靠语法高亮判断对错，它依赖 SDK 和模块路径做语义分析。爆红但 go build 成功，大概率是 IDE 没识别到正确的 Go 环境。
- 打开 Settings → Go → GOROOT，确认指向的是你本地安装的 Go 目录（如
/usr/local/go或C:\Go），不是某个子目录或空路径 - 检查 Settings → Go → GOPATH：如果项目用 Go Modules（即根目录有
go.mod），这里可以留空；否则必须和终端里echo $GOPATH输出一致 - 右键项目根目录 → Reload project，强制重新解析
go.mod和依赖
爆红出现在 import 包名上？大概率是 vendor 或 replace 未生效
GoLand 默认不读取 go mod vendor 生成的 vendor/ 目录，也不自动应用 replace 指令——除非你手动启用。
- 进入 Settings → Go → Build Tags & Vendoring
- 勾选 Enable vendoring support（如果用了
vendor/） - 勾选 Enable Go modules integration（必须开启，否则 ignore
go.mod） - 若
go.mod中有replace，确保对应路径存在且可读；GoLand 不会自动 clone 替换目标，本地路径必须真实存在
struct 字段爆红说 “cannot refer to unexported field”？注意大小写和包作用域
这不是配置问题，而是 Go 的导出规则在 IDE 里被严格校验了。即使你在同一包内访问小写字段，GoLand 也可能误报——尤其跨文件时。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认字段名首字母是小写（如
name string），且调用处和定义处在**同一个包**（package mainvspackage foo） - 检查文件顶部是否有隐藏的空行或 BOM 字符，导致 GoLand 解析包声明失败（可右键文件 → File Encoding → 设为 UTF-8 without BOM）
- 如果字段属于第三方包，爆红说明该字段确实不可见——GoLand 这次没骗你，别硬改
重启后还爆红？试试 invalidate cache + 命令行验证
GoLand 的索引有时会卡住，特别是频繁切换分支或修改 go.mod 后。别急着重装，先清缓存。
- 菜单栏 File → Invalidate Caches and Restart → Just Restart（先试这个）
- 如果不行，选 Invalidate and Restart，清掉所有索引
- 重启后仍爆红，立刻切到终端执行：
go list -f '{{.Deps}}' ./...，看是否报错；如果命令行也报错，问题不在 IDE，在你的模块依赖本身
真正麻烦的是混合使用 GOPATH mode 和 module mode 的老项目——GoLand 对这种边界情况的提示很弱，得手动关掉 module 支持再试，或者干脆统一迁移到 go.mod。
