go环境搭建关键在gopath、gobin和goproxy三处配置，尤其需注意多版本共存、包管理器混用及国内网络代理问题，正确设置path、goproxy=https://goproxy.cn,direct和go111module=on可避免90%的常见错误。
Go 语言环境搭建本身不难，但容易卡在 GOPATH、GOBIN 和模块代理（GOPROXY）这三处——尤其是 macOS 或 Windows 上装了多个 Go 版本，或用 Homebrew / Chocolatey / 官方安装包混搭时。
确认系统是否已装 Go 及版本是否合适
别急着重装，先查清楚当前状态。终端运行：
go version
如果报错 command not found: go，说明没装；如果输出类似 go version go1.19.12 darwin/arm64，注意两点：
- Go 1.16+ 已默认启用模块（modules），不再强制依赖
GOPATH，但旧项目或某些工具仍会读取它 - Go 1.21+ 开始，
GOROOT通常自动推导，手动设反而易出错；而GOPROXY若未设，国内用户大概率go get卡住或超时 - 若版本低于 1.19，建议升级——1.19 是最后一个支持 Windows 7 的版本，之后的版本对 TLS 1.3、ARM64 优化更稳
macOS / Linux 下推荐用官方二进制包而非包管理器
Homebrew 安装的 Go 常因权限或符号链接问题导致 go install 失败，尤其当你用 go install 安装 CLI 工具（如 gopls、buf）时。
- 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统的
go*.tar.gz（如go1.22.4.darwin-arm64.tar.gz） - 解压到
/usr/local：sudo rm -rf /usr/local/go<br>sudo tar -C /usr/local -xzf go*.tar.gz
- 确保
/usr/local/go/bin在$PATH前置位（加到~/.zshrc或~/.bash_profile）：export PATH="/usr/local/go/bin:$PATH"
- 执行
source ~/.zshrc后验证which go输出应为/usr/local/go/bin/go
Windows 上避开 MSI 安装器的 PATH 坑
MSI 安装器默认勾选“Add Go to PATH”，但实际可能只加到用户 PATH，而 VS Code 终端或某些 IDE 启动时读的是系统 PATH，导致 go 命令找不到。
- 下载
go*.msi后，**取消勾选“Add Go to PATH”**，手动配置更可控 - 安装完后，手动把
C:\Go\bin加入系统环境变量PATH（不是用户变量） - 重启所有终端和编辑器——Windows 下 CMD/PowerShell/VS Code 三者 PATH 缓存不同步很常见
- 验证：打开新 PowerShell，运行
$env:PATH -split ';' | Select-String 'Go'，确认路径存在
必须设置的三个环境变量（尤其在国内）
GOPROXY 不设，go mod download 会直连 proxy.golang.org，99% 情况下失败；GOSUMDB 不关，校验失败也会中断构建。
-
GOPROXY=https://proxy.golang.org,direct→ 推荐换成国内镜像：GOPROXY=https://goproxy.cn,direct（阿里云维护，稳定） -
GOSUMDB=off或GOSUMDB=sum.golang.org→ 若用goproxy.cn，建议设为sum.golang.org；若网络不稳定，临时设off（仅调试用） -
GO111MODULE=on→ Go 1.16+ 默认开启，但某些旧 shell 配置可能覆盖它，显式声明更稳妥
设法：Linux/macOS 写进 shell 配置；Windows 在系统环境变量里新增——别只设用户变量。
设完后，跑一次 go env -w GOPROXY=https://goproxy.cn,direct，Go 会持久化写入 $HOME/go/env，比 shell 变量更可靠。
真正麻烦的从来不是“装上 Go”，而是后续 go run 报 cannot find module providing package，或 go install 出来的二进制找不到——那八成是 PATH、GOPROXY 或多版本共存时 GOROOT 混乱导致的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
