go命令能运行但go mod报错、go install装错位置、ide提示“gopath not set”，说明环境变量已配置但未被工具链真正识别；常见表现为echo $gopath有值而go env gopath为空或错误，根源在于shell或ide未加载配置文件，需检查shell类型、配置文件路径、source生效、ide环境继承及gobin显式设置。
Go命令能运行，但go mod报错、go install装到错误位置、IDE提示“GOPATH not set”——说明本地工作区配置没被工具链真正识别，不是没设，而是没生效。
go env 显示 GOPATH 为空或不对
这不代表你没写配置，而是 shell 或 IDE 没加载它。常见现象是终端里 echo $GOPATH 有值，但 go env GOPATH 输出空或默认路径。
- macOS/Linux 用户检查用了哪个 shell：
echo $SHELL，再确认对应配置文件（~/.zshrc对 zsh，~/.bash_profile对 bash）是否真写了export GOPATH=$HOME/go并执行了source ~/.zshrc - Windows 用户注意：PowerShell 和 CMD 的环境变量不互通；用 PowerShell 安装的 Go，CMD 里
go就找不到；反之亦然 - VS Code 启动方式影响环境继承：从 Dock 或开始菜单点开的 VS Code 不读 shell 配置；必须从终端执行
code .启动，才能继承当前 shell 的GOPATH - JetBrains 系列 IDE（GoLand）需在 Settings → Go → GOROOT 页面点 “Reload” 才刷新
go env值，重启 IDE 更稳妥
go install 把二进制装进 /usr/local/go/bin 或报 permission denied
这是 GOBIN 缺失或 GOPATH 未被识别的典型表现。Go 在找不到 GOBIN 时会 fallback 到 $GOPATH/bin；如果 GOPATH 也空，就可能误用 GOROOT 下的目录，而那里通常需要 root 权限。
- 显式设置
GOBIN：在 shell 配置里加一行export GOBIN=$HOME/go/bin，并确保该目录存在（mkdir -p $GOBIN） - 不要依赖
go env -w GOPATH=...：这个写法只影响当前用户级配置，某些 CI/IDE/容器场景下不可靠；优先用 shell 配置文件硬编码 - 验证是否生效：
go env GOBIN应输出你设的路径；然后运行go install golang.org/x/tools/cmd/gopls@latest，再看$GOBIN下是否有gopls文件
go mod init 失败提示 malformed module path 或 cannot determine module path
这不是 GOPATH 问题，而是模块初始化时路径不合法，常被误认为工作区配置失败。根本原因是当前目录名或你传给 go mod init 的参数不符合 Go 模块路径规范。
- 模块路径不能以大写字母开头：
go mod init MyProject❌；应改为小写+连字符：go mod init example.com/hello-world✅ - 不能含空格或中文：
go mod init 我的第一个项目❌；先重命名目录为first-project再 init - 避免用相对路径：
go mod init ./myproj❌；Go 要求模块路径是可导入的域名风格，不是文件系统路径 - 临时测试可用
go mod init temp，但后续引入其他模块时会因路径不匹配导致import失败，仅限单文件快速验证
最易被忽略的一点：Go Modules 启用后，GOPATH 不再决定项目位置，但它仍控制 go install 输出目录和 gopls 的缓存行为。哪怕你全程用模块开发，$GOPATH/pkg/mod 和 $GOBIN 依然在后台起作用——配错一个，IDE 就可能反复卡在“loading packages”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
