goland报红但go build成功，本质是ide未对齐本地go配置：需手动设置goroot、启用go modules、配置goproxy、同步项目并清除缓存。
GoLand 报红但 go build 成功，本质是 IDE 环境没对齐
这不是代码问题，而是 GoLand 没加载到你本地的 Go 配置。它不读 shell 的 .zshrc 或 .bash_profile，启动时用的是空环境或系统默认值。
常见现象：终端里 go list -m all 能列出所有模块，GoLand 却标红 github.com/gin-gonic/gin；或者提示 can't find import: net/http 这种标准库都找不到。
- 进 File > Settings > Go > GOROOT，手动指定你的 Go 安装路径（比如
/usr/local/go或C:\Program Files\Go），别依赖自动探测 - 在同一页检查 Go Modules 是否勾选了 Enable Go Modules (vgo)；没勾就打上勾
- 确认
GO111MODULE是on：终端执行go env GO111MODULE，如果不是on，运行go env -w GO111MODULE=on - 右键项目根目录 → Synchronize，强制刷新索引；如果还不行，用 File > Invalidate Caches and Restart > Invalidate and Restart
go mod tidy 成功但 GoLand 仍报红，大概率缓存没更新
GoLand 的模块解析和 go mod 工具不是同一套逻辑。它会缓存 go.mod 解析结果，有时改完 go.mod 后它根本没重读。
典型表现：你刚 go get github.com/sirupsen/logrus@v1.9.0，go.mod 显示更新了，但 GoLand 里 logrus.WithError() 还是灰色、点不进去。
- 先执行
go mod vendor（可选，但能帮 IDE 更快定位包路径） - 在 GoLand 中右键项目 → Load project from external model > Go modules
- 或者打开 View > Tool Windows > Go Modules，点右上角刷新按钮
- 删掉项目下
.idea/modules.xml和.idea/misc.xml，再重启 GoLand（它会重建）
私有仓库或国内代理配置缺失，GoLand 根本拉不到包
GoLand 默认用 GOPROXY 下载依赖，但它不会自动继承你终端里设置的代理——尤其当你用 go env -w GOPROXY=... 之后没重启 IDE。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
错误提示常是：go list -m: github.com/your-org/internal-lib@v0.1.0: Get "https://goproxy.cn/...": dial tcp: lookup goproxy.cn: no such host，或直接卡在 “Resolving dependencies…”。
- 进 Settings > Go > Go Modules，找到 Proxy Server 输入框，填入：
https://goproxy.cn,direct（不要加http://，也不要空格） - 如果有私有 Git 域名（如
git.company.com），必须同时设GOPRIVATE：在 Settings > Go > Environment 里加一行GOPRIVATE=git.company.com - 验证是否生效：在 GoLand 终端里运行
go env | grep -E "(GOPROXY|GOPRIVATE)"，输出应和你刚填的一致
导入路径写错导致 GoLand 和 go build 行为不一致
GoLand 的代码补全和跳转依赖 import 字符串是否“看起来合法”，而 go build 只认 go.mod 里声明的 module 名 + 目录路径是否真实存在。两者判断逻辑不同，容易出现一方通过、另一方报错。
例如你在 go.mod 写了 module github.com/myname/project，却在代码里写 import "myname/project/utils" —— go build 会失败，但 GoLand 可能只标黄不报红，甚至补全出错函数。
- 所有 import 必须以
github.com/...或你go.mod中声明的完整 module 名开头，不能省略 - 用
go list -f '{{.Dir}}' github.com/myname/project/utils验证路径是否存在；空输出说明这个子包在当前锁定版本里压根没发布 - 如果用了
replace，确保go.mod里replace行左侧的 module 名和 import 语句完全一致（包括大小写、斜杠、v2 后缀）
最易被忽略的一点：GoLand 的 Go SDK 配置和模块设置是两个独立开关，关掉任意一个都会让依赖解析失效。很多人只配了 GOROOT，忘了勾选 Enable Go Modules，结果折腾半天 proxy 和 cache，其实只是少点了一个勾。
