go环境配置的核心是精准设置path、goroot和gopath：path必须包含go的bin目录并reload shell配置，goroot仅在homebrew或手动解压时需显式设置，gopath在模块模式下非必需但影响go install路径，goproxy推荐设为“https://goproxy.cn,direct”。
Go 环境搭得“优雅”，不在于装得多 fancy，而在于路径清晰、可复现、不踩 go env 里那些静默失效的坑。核心就一条：GOROOT 和 GOPATH 不要凭感觉设，PATH 必须精准包含 bin 目录，且 shell 配置要 reload 到当前终端。
go command not found？先盯死 PATH 和 shell 配置文件
这是 macOS/Linux 上最常卡住的一步。不是没装好，而是 shell 没读到路径。
-
go命令找不到，先运行which go—— 如果没输出，说明 PATH 没生效 - 用
.pkg安装的 Go 默认把/usr/local/go/bin写进/etc/paths，但只对新终端生效；你开的旧终端不会自动 reload - Homebrew 安装的 Go 路径是
/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），必须确保该路径在$PATH前面，否则可能被系统旧版覆盖 - 检查你用的 shell（
echo $SHELL），然后编辑对应配置文件：~/.zshrc（macOS Catalina 及以后默认）、~/.bash_profile或~/.profile，追加export PATH="/usr/local/go/bin:$PATH"或 Homebrew 对应路径 - 改完别忘了
source ~/.zshrc（或对应文件），再新开终端验证go version
GOPATH 还需要手动设吗？看场景再决定
Go 1.16+ 默认启用模块模式（GO111MODULE=on），GOPATH 对 go build 和 go run 已无硬性依赖。但它仍影响三件事：go install 生成的二进制存放位置、go get 下载的旧式包路径、以及部分老工具（如 gopls）的缓存行为。
- 如果你只写模块项目、用
go mod管理依赖，GOPATH可以完全不管——go install会默认落到$HOME/go/bin，只要这个路径在PATH里就行 - 如果要用
go get github.com/xxx/cli@latest安装命令行工具，且希望它全局可用，就得确保$GOPATH/bin在PATH中；此时建议显式设GOPATH=$HOME/go，避免某些工具误读空值 - Windows 用户注意：
%GOPATH%\bin必须加进系统环境变量Path，且不能带引号、不能有中文或空格 - 别在
go.mod里写GOPATH—— 它不是模块配置项，纯属环境变量
GOROOT 什么时候必须手动配？
GOROOT 是 Go 标准库和编译器所在路径，绝大多数情况无需手动设置。
- 官方
.pkg或.msi安装后，GOROOT自动设为/usr/local/go（macOS/Linux）或C:\Program Files\Go（Windows），go env GOROOT会正确返回 - 只有当你用 Homebrew 安装 Go（路径在
/opt/homebrew/Cellar/go/x.y.z/libexec）时，go env GOROOT可能为空或错误，这时必须手动设：export GOROOT=$(brew --prefix go)/libexec - 手动解压
tar.gz到非标准路径（比如/opt/go）时，也得显式 exportGOROOT=/opt/go - 错误设
GOROOT的典型症状：go build报cannot find package "fmt"或其他标准库包 —— 说明编译器找不到 runtime 和 std
国内用户绕不开的 GOPROXY，别只设一半
不设代理，go mod download 或 go get 极易卡在 proxy.golang.org，超时失败。但只设 GOPROXY=https://goproxy.cn 也不够稳健。
- 推荐完整写法：
export GOPROXY=https://goproxy.cn,direct——direct表示对私有模块（如公司内网 Git）跳过代理直连 - 如果用的是企业级私有模块仓库（如 Nexus、JFrog），要把其地址加在
direct前面，例如：GOPROXY=https://goproxy.cn,https://mycompany.com/go-proxy,direct - 验证是否生效：运行
go env GOPROXY，输出应与你设置一致；再执行go mod download golang.org/x/net，几秒内完成即成功 - VS Code 或 GoLand 用户注意：IDE 可能用自己的 shell 环境，需在 IDE 设置里指定 shell path（如
/bin/zsh），否则GOPROXY不生效
路径配置真正麻烦的从来不是“怎么写”，而是“写在哪”和“谁读到了”。每次改完环境变量，务必确认当前终端进程已加载，而不是凭记忆以为“应该好了”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
