Go环境配置核心是理清GOROOT（通常无需手动设）、GOBIN与PATH配对（export GOBIN=$HOME/go/bin且$GOBIN在PATH前）、GOPROXY设为https://goproxy.cn,direct并GOSUMDB=off。
Go 语言环境搭不好，go run 报错、GOROOT 和 GOBIN 冲突、模块初始化失败——根本不是你不会写代码，而是环境变量和路径逻辑没理清。
确认系统是否已装 Go，别重复安装
很多人反复下载安装包，结果 which go 显示的是旧版本或 Homebrew 装的残留。先查真实路径：
go version && which go
如果输出类似 /usr/local/go/bin/go，说明系统级已装；如果是 /opt/homebrew/bin/go（macOS M1/M2），那大概率是 Homebrew 装的。二者共存极易导致 GOROOT 指向错误。
- 删 Homebrew 版：执行
brew uninstall go，再删掉/usr/local/bin/go这类软链 - 只保留官方二进制安装：从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统 tar.gz，解压到
/usr/local/go - 验证：
ls /usr/local/go/bin/go存在，且go version输出带go1.22或更高
GOROOT 通常不用手动设
官方安装包会把 GOROOT 默认设为 /usr/local/go，只要不挪动这个目录，就别在 ~/.zshrc 或 ~/.bashrc 里硬写 export GOROOT=...。手动设反而容易覆盖默认行为，尤其升级 Go 后旧路径失效，go env GOROOT 会显示错误值。
立即学习“go语言免费学习笔记（深入）”；
- 检查当前值：
go env GOROOT—— 正常应输出/usr/local/go - 如果输出空或错，删掉所有 shell 配置里的
GOROOT=行，重开终端 - 只有当你把 Go 解压到非标准路径（如
~/go-1.22）才需显式设置
GOBIN 和 PATH 必须配对生效
GOBIN 控制 go install 编译出的二进制放哪，但它本身不自动加入 PATH。常见现象：执行 go install golang.org/x/tools/gopls@latest 成功，但敲 gopls 提示 command not found —— 就是 GOBIN 路径没加进 PATH。
- 推荐设
GOBIN为$HOME/go/bin（避免权限问题） - 在 shell 配置中加两行：
export GOBIN=$HOME/go/bin<br>export PATH=$GOBIN:$PATH
- 注意顺序：
$GOBIN必须在$PATH前面，否则系统自带的旧版工具会优先被找到 - 生效后验证：
echo $PATH | grep go应含$HOME/go/bin；which gopls应输出该路径
模块代理和校验和要关还是开？看场景
国内直连 proxy.golang.org 基本超时，但盲目设 GOPROXY=https://goproxy.cn 也可能引发依赖校验失败（尤其私有模块或 commit hash 引用）。真正要调的是两个变量：
-
GOPROXY：设为https://goproxy.cn,direct（逗号分隔，direct是 fallback） -
GOSUMDB：国内镜像不提供 sumdb，必须设为off，否则go mod download卡住 - 验证：
go env GOPROXY GOSUMDB应输出对应值 - 注意：设
GOSUMDB=off仅影响校验，不影响安全性——模块仍从源站下载，只是跳过哈希比对
路径、变量、代理这三块理顺了，go mod init 和 go run main.go 才真能稳定跑起来。最常被忽略的是 GOBIN 和 PATH 的配对，以及 GOSUMDB=off 这个必要开关。
