根本原因是goland未加载shell环境变量，导致goroot/gopath缺失；需手动配置goroot、启用go modules集成、检查go.mod路径及包导入格式，并清理.idea缓存。
GoLand 报 “cannot find package” 但命令行正常
根本原因是 IDE 启动时没加载 shell 中的 GOROOT 和 GOPATH。图形界面应用（如 GoLand）默认不读 .zshrc 或 .bash_profile，导致它找不到 Go 安装路径和标准库。
验证方法：在 GoLand 的 Terminal 里执行 go env GOROOT，如果输出为空或错误路径，就坐实了这个问题。
- 最稳解法：在 GoLand 的 Preferences → Go → GOROOT 手动指定你的 Go 安装目录（例如
/usr/local/go或C:\Go） - 别依赖“自动检测”——GoLand 的 auto-detect 经常漏掉符号链接或自定义安装路径
- 如果项目用 Go Modules（
GO111MODULE=on），GOPATH对依赖解析影响已很小，但GOROOT必须正确，否则连fmt、time都标红
GoLand 中本地包 import 路径标红或报 “undefined”
不是路径写错了，就是模块上下文没对上。GoLand 会严格按 go.mod 第一行的 module 名 + 目录结构来解析导入路径，不认 ./utils 或裸名 utils。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 检查
go.mod文件首行：module github.com/yourname/myproject—— 这个就是你所有本地包的前缀 - 假设你有个
utils/目录，里面utils.go声明了package utils，那么导入语句必须是import "github.com/yourname/myproject/utils" - 如果用了
go work工作区，确保go.work文件存在且包含对应模块路径，否则 GoLand 不会把多个模块当一个上下文索引 - 删掉
.idea目录再重开项目——旧缓存常导致包路径识别滞后，尤其改过go.mod后
启用 Go Modules 后 IDE 仍提示 “package xxx is not in GOROOT”
典型症状是：能 go run 成功，但 GoLand 里 import 第三方包（如 github.com/gin-gonic/gin）标红，并报这个错。本质是 IDE 没启用 Modules 集成，还在用老式 GOPATH 模式扫描。
- 进 Preferences → Go → Go Modules，勾选
Enable Go Modules integration - 确认
Proxy设置合理（比如https://goproxy.cn），否则 IDE 索引依赖时超时失败 - 关闭
Use GOPATH that contains manually added modules—— 这个选项和 Go Modules 冲突，开了反而让 IDE 回退到 GOPATH 模式 - 如果项目根目录没有
go.mod，先在 Terminal 里执行go mod init your-module-name，再让 GoLand 重新加载
自定义包名含 _test.go 导致无法被 import
Go 编译器会把文件名以 _test.go 结尾的整个包识别为测试包，禁止被非测试代码 import。这不是 GoLand 的 bug，是语言规范。
- 现象：
client_test/目录下有client_test.go，main 包 import 它时报undefined: client_test - 解决：重命名目录为
clienttest，同时把文件内package client_test改成package clienttest - 别只改文件名不改
package声明——两者必须一致，否则编译失败 - 导出函数名也得首字母大写：
func Send()可以被外部调用，func send()就是私有的
真正卡住人的往往不是某一个配置，而是多个条件叠加失效：比如 go.mod 路径写错 + GOROOT 未手动设置 + IDE 缓存未清。建议按顺序逐项检查，别跳步。
