GoLand中import报红但代码可运行，主因是IDE未正确识别module上下文或GOPROXY配置失效；需检查go.mod存在性、启用Go Modules、配置有效代理（如https://goproxy.cn）、设置GOPRIVATE（私有仓库）、在项目根目录执行go get后右键Reload project或清理缓存重启。
GoLand 里 import 第三方包报 red squiggle，但代码能跑
这是最常见错觉：IDE 报错但 go run 成功。根本原因是 GoLand 没识别到当前 module 上下文，或 GOPROXY 配置失效。
检查点：
- 确认项目根目录存在
go.mod文件；不存在就执行go mod init your-module-name - 在 GoLand 设置中打开 Settings → Go → Go Modules (vgo)，勾选 Enable Go Modules integration
- Proxy 必须填有效地址，推荐
https://goproxy.cn或https://proxy.golang.org；不要留空或写错拼写（比如goproxy.cn少了https://） - 如果用了私有仓库（如 GitLab 内部模块），需额外配置
GOPRIVATE环境变量，否则 GoLand 会跳过认证直连失败
用 go get 下载包后，GoLand 还是标红
不是下载完就自动生效。GoLand 依赖 go list -m all 的结果来索引依赖，而这个命令受 GO111MODULE 和当前工作目录影响。
实操建议：
- 别在终端随便切目录后执行
go get；确保 cd 到项目根目录（含go.mod）再运行go get github.com/gin-gonic/gin - 执行完后，在 GoLand 中右键项目 → Reload project（不是 “Reload from disk”）
- 如果仍不识别，手动触发索引：菜单栏 File → Invalidate Caches and Restart → Just Restart（缓存损坏很常见）
- 注意：
go get后不会自动更新go.mod里的版本号（除非加@latest或明确版本），想锁死版本请用go get github.com/gin-gonic/gin@v1.9.1
导入路径写对了，却提示 “cannot find package”
错误信息是 cannot find package "github.com/xxx/yyy"，但你确定 URL 可访问、go get 也成功了——问题大概率出在 module 名和导入路径不一致。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
典型场景：
- 你在
~/myproj执行go mod init myproj，但代码里写了import "github.com/myorg/myproj/utils"→ 路径和 module 名不匹配，GoLand 无法映射 - 第三方包本身用了 replace（如本地调试时
replace github.com/a/b => ./local-b），但 GoLand 没读取到该行，仍按原始路径找 - 包路径含大写字母（如
MyLib），而实际仓库名是小写（mylib）；Go 对大小写敏感，GitHub URL 和 import 路径必须完全一致
GoLand 自动补全不出现第三方包函数
补全失效 ≠ 导入失败，而是 GoLand 没加载包的 AST 信息。这通常发生在包没被显式 import，或类型未被实际使用。
解决办法：
- 确保该包至少在一个
.go文件中被import声明（哪怕只写import _ "github.com/go-sql-driver/mysql"） - 避免仅靠 “点导入”（
import . "fmt"）来触发索引；GoLand 对点导入支持弱，优先用常规导入 + 显式调用 - 检查 Go SDK 是否正确指向
GOROOT（不是GOPATH）；设置路径错误会导致标准库符号都不可见，进而连带影响第三方包解析 - 某些包（如
cgo依赖的）需要开启 Settings → Go → Build Tags，填入对应 build tag（如sqlite_unlock_notify）才能完整加载
最容易被忽略的是：GoLand 的 module 解析完全依赖 go list 输出，而不是文件系统路径。哪怕你把包源码拷进 vendor/ 或 src/，只要 go.mod 没声明、go list 不返回它，GoLand 就当它不存在。
