在 macos 中，仅在 `.profile` 或 `.bashrc` 中赋值 `gopath` 而未使用 `export` 声明，会导致该变量无法被 go 工具链读取；必须显式导出环境变量，并确保 shell 启动时正确加载配置文件。
在 macOS Yosemite 及后续版本（包括 Catalina、Ventura、Sonoma）中，Shell 默认行为与配置文件加载机制是导致 GOPATH 设置“无效”的常见根源。你遇到的问题——go env 显示 GOPATH=""，即使已在 .profile 中写入 GOPATH="$HOME/go"——本质上是因为该变量未被导出为环境变量，因此子进程（如 go 命令）无法继承它。
✅ 正确写法：必须 export
错误写法（仅赋值，不导出）：
GOPATH="$HOME/go" # ❌ 变量仅在当前 shell 作用域存在 PATH="$PATH:$GOPATH/bin"
正确写法（显式导出）：
export GOPATH="$HOME/go" # ✅ 导出后，所有子进程均可访问 export PATH="$PATH:$GOPATH/bin"
? 提示：export VAR=value 等价于 VAR=value; export VAR，但推荐合并书写，语义清晰且不易遗漏。
? 配置文件选择：.bash_profile 优先于 .profile（macOS Terminal 默认）
macOS 的 Terminal.app 默认启动的是 login shell，而它按以下顺序查找并执行首个存在的配置文件：
- ~/.bash_profile
- ~/.bash_login
- ~/.profile
⚠️ 如果你同时存在 .bash_profile 和 .profile，只有 .bash_profile 会被加载（其余被忽略）。因此，即使你在 .profile 中正确写了 export GOPATH，只要 .bash_profile 存在（哪怕为空），它就不会生效。
✅ 推荐做法（统一管理）：
- 删除或重命名 .bash_profile（如暂不需要），确保 .profile 被读取；
- 或者——更推荐：将所有环境变量配置集中到 ~/.bash_profile 中（因为 macOS 用户普遍使用 Bash/Zsh，默认终端行为更稳定）：
# ~/.bash_profile export GOPATH="$HOME/go" export PATH="$PATH:$GOPATH/bin" export PATH="/usr/local/go/bin:$PATH" # 确保 GOROOT/bin 在 PATH 前置（可选但推荐）
? 修改后务必重新加载配置：
source ~/.bash_profile # 或重启终端，再验证： go env GOPATH # 应输出 /Users/yourname/go
? 补充说明：Zsh 用户注意（macOS Catalina+ 默认 Shell）
如果你使用的是 macOS Catalina 或更高版本，默认 Shell 已切换为 zsh，此时应配置 ~/.zshrc 或 ~/.zprofile：
# ~/.zshrc（交互式非登录 shell）或 ~/.zprofile（登录 shell，更推荐） export GOPATH="$HOME/go" export PATH="$PATH:$GOPATH/bin"
然后运行 source ~/.zprofile 生效。
✅ 验证是否成功
执行以下命令确认环境已正确加载：
echo $GOPATH # 应输出路径，如 /Users/xxx/go
go env GOPATH # 必须与上行一致
go list -f '{{.Dir}}' std # 若能正常输出，说明 GOPATH/GOROOT 均就绪⚠️ 注意事项总结
- GOPATH 不再是 Go 1.16+ 的强制要求（模块模式默认启用），但 go install、第三方工具（如 gopls、delve）及传统工作流仍依赖它；
- GOROOT 通常无需手动设置（Go 安装器已内置），切勿随意覆盖；
- 避免在多个配置文件中重复或冲突设置 PATH，否则可能导致 go 命令找不到或版本混乱；
- 使用 go env -w GOPATH=... 可写入 Go 内部配置（Go 1.13+），但不推荐替代 shell 环境变量，因其仅影响 go 命令本身，不影响其他依赖 GOPATH 的工具。
正确导出 + 正确加载 + 正确验证 = GOPATH 稳定生效。
