GOPATH未正确设置或目录结构缺失时，需先判断是否需要GOPATH模式：新项目有go.mod则无需；老项目无模块则需手动创建$HOME/go/{src,pkg,bin}标准结构，并确保GOBIN=$GOPATH/bin且在PATH中。
go env GOPATH 显示空或路径不存在
直接执行 go env GOPATH，如果输出为空、"" 或指向一个根本不存在的路径（比如 /home/user/go 但该目录连 src 都没有），说明 GOPATH 没被正确设置或目录结构缺失。这不是 IDE 或 shell 缓存问题，而是 Go 工具链压根找不到合法工作区。
别急着改环境变量——先确认你是否真需要 GOPATH 模式：
- 新项目（Go 1.16+）且有
go.mod文件 → 不需要 GOPATH，go build和go run可在任意目录运行，go install默认走模块缓存（$GOPATH/pkg/mod），不依赖$GOPATH/src - 老项目没
go.mod，或用go get下载无模块包 → 必须有合规的 GOPATH 目录结构
手动重建 GOPATH 目录结构（Linux/macOS/Windows 均适用）
假设你想把 GOPATH 设为 $HOME/go（Windows 是 %USERPROFILE%\go），执行以下命令创建标准三层结构：
mkdir -p $HOME/go/{src,pkg,bin}
注意：pkg 和 bin 必须是空目录，不能是符号链接；src 里不要放任何 .go 文件——它只是“源码根容器”，具体项目要放在 src/xxx/yyy 下，例如 $HOME/go/src/myproject/main.go。
立即学习“go语言免费学习笔记（深入）”；
常见错误：
- 只建了
src，漏掉pkg或bin→go install报no install location - 把项目直接放到
$HOME/go根目录 → Go 不认，必须进src子目录 - 路径含中文或空格 → 某些旧版 Go 工具链会解析失败，建议纯英文路径
GOPATH 设置后 go install 还往 GOROOT 写？检查 GOBIN
即使 go env GOPATH 正确，go install 仍报 permission denied 或写到 /usr/local/go/bin，大概率是 GOBIN 没设或为空。
验证：go env GOBIN 应输出 $GOPATH/bin（如 /home/user/go/bin）。若为空，补上：
export GOBIN=$GOPATH/bin
然后确保 $GOBIN 在 PATH 中（否则装完也找不到命令）：
export PATH=$PATH:$GOBIN
关键点：Go 优先用 GOBIN，其次才 fallback 到 $GOPATH/bin。很多教程只设 GOPATH 却漏了 GOBIN，导致 install 行为异常。
GoLand / VS Code 里 GOPATH 不生效的典型原因
终端里 go env GOPATH 正确，但 IDE 内置终端或调试器报 cannot find package "xxx"，通常是因为 IDE 没继承 shell 环境变量。
解决方法分场景：
- macOS VS Code：不要双击图标启动，从终端执行
code .，否则读不到~/.zshrc - GoLand（Windows/macOS）：进入
File → Settings → Go → GOROOT，手动填入GOROOT路径；再检查Go → GOPATH是否勾选 “Index entire GOPATH” 并已添加你的 GOPATH 路径 - 所有 IDE：打开内置终端，先执行
go env GOPATH确认值，再运行go list -m看是否识别模块 —— 如果报not in a module却又有go.mod，说明 GO111MODULE 被意外关了
最隐蔽的坑：某些 IDE 启动时会读系统级环境变量（如 Windows 的系统属性→环境变量），而忽略用户级配置。务必在 IDE 内置终端里直接验证 go env 输出，别信“设置里填了就等于生效”。
