go环境搭建核心是准确配置goroot（必须）、合理使用gopath（可选）、正确设置goproxy（含direct）与go111module=on，并验证path指向真实bin目录，其余变量初期可忽略。
Go 环境搭建不是“装完就完”，真正卡住人的从来不是 go version 能否输出，而是后续 go run 报错、go mod download 超时、GOPATH 和 GOROOT 混用导致依赖找不到——这些都源于笔记没分清「谁该记」和「谁该忘」。
区分 GOROOT 和 GOPATH 的实际作用场景
很多人抄笔记时把两者并列写成“必须设置的环境变量”，但 Go 1.14+ 实际只强制需要 GOROOT（Go 安装路径），而 GOPATH 在启用 go mod 后已退化为可选：
-
GOROOT必须准确指向你安装的 Go 目录（如/usr/local/go或/opt/homebrew/opt/go@1.26），否则go命令根本无法启动 -
GOPATH只影响go get（无go.mod时）和go install的默认安装位置；现代项目基本不用它存源码，~/go只需保留bin子目录用于存放go install生成的工具（如gopls、goimports） - Apple Silicon 用户特别注意：
brew install go@1.26默认把GOROOT设为/opt/homebrew/opt/go@1.26/libexec，不是/opt/homebrew/bin/go——后者只是 shell wrapper
GOPROXY 配置要绑定具体错误现象记
别只记“设成 https://goproxy.cn,direct”，要对应到真实报错才能快速定位：
- 看到
proxy.golang.org:443: dial tcp: i/o timeout→ 立刻检查go env GOPROXY是否仍为默认值 - 遇到
verifying github.com/xxx@vX.Y.Z: checksum mismatch→ 不是代理问题，是本地缓存损坏，应执行go clean -modcache，而非反复改GOPROXY - 公司内网环境若禁外网，
direct必须保留（逗号后不可删），否则私有模块会因无法 fallback 而失败
PATH 设置必须验证二进制实际位置
Homebrew 安装后自动加 PATH 是假象，很多用户没意识到：brew install go@1.26 创建的是符号链接，而 PATH 中真正生效的是 go 命令所在目录：
- Intel Mac：确认
which go输出是否为/usr/local/bin/go，再查ls -l /usr/local/bin/go看它链向/usr/local/opt/go@1.26/libexec/bin/go - Apple Silicon：
which go应为/opt/homebrew/bin/go，但实际执行文件在/opt/homebrew/opt/go@1.26/libexec/bin/go - 手动安装用户常漏一步：解压后必须把
/usr/local/go/bin加入 PATH，而不是/usr/local/go——后者不含可执行文件
go env 输出要过滤掉干扰项
go env 一次性输出 20+ 行，新手笔记常全抄，但真正需盯住的只有 4 项：
-
GOROOT：是否与你安装路径一致？不一致说明 PATH 指向了旧版本 -
GOBIN：是否为空？为空时go install会默认装到$GOPATH/bin，若GOPATH未设就会失败 -
GOPROXY：是否含direct？缺它会导致私有模块拉取失败 -
GO111MODULE：是否为on？关着时go mod init会报错 “unknown command”
其余如 GOSUMDB、GONOPROXY 属于进阶配置，初期笔记里写“暂不启用”比乱填更稳妥。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
