go环境搭建关键在正确配置goroot、gobin、gopath、go111module和goproxy，并确保shell初始化完整；macos需更新~/.zshrc，windows注意powershell与cmd环境隔离，wsl2须单独配置linux路径且避免/mnt/c/开发。
Go 语言环境搭建本身不复杂，但容易卡在 GOPATH、GOBIN、模块代理和 shell 初始化这几个环节——尤其是当你用的是 macOS（zsh）、Windows（PowerShell 或 CMD 混用）、或 WSL2 时，路径和环境变量一配错，go run 能跑，go install 却提示 “command not found”，或者 go get 直接超时失败。
确认系统架构与下载正确安装包
别直接点官网首页的 “Download Go” 按钮——它默认推给你当前浏览器 UA 对应的版本，不一定匹配你的实际系统。先终端里敲：
uname -m # Linux/macOS echo $env:PROCESSOR_ARCHITECTURE # PowerShell
重点看是 amd64 还是 arm64（M1/M2 Mac、部分新 Windows 笔记本）。选错会导致安装后 go version 报错 “cannot execute binary file”。官方下载页按 OS + Arch 分组，手动选准。Windows 用户注意：优先下 .msi（自动配环境变量），而非 .zip（需手动解压+PATH）。
安装后必须验证的三个环境变量
运行 go env，重点关注这三项是否合理：
-
GOROOT：应指向你安装 Go 的根目录（如/usr/local/go或C:\Program Files\Go），不是你自己建的项目文件夹 -
GOROOT必须和which go（macOS/Linux）或where go（Windows CMD）返回路径一致，否则说明 PATH 没生效 -
GO111MODULE建议显式设为on（哪怕你只写小脚本），避免旧项目依赖GOPATH模式引发混淆 -
GOPROXY强烈建议设为https://proxy.golang.org,direct（国内可换https://goproxy.cn），否则go mod download极易卡住
macOS / Linux 下 shell 初始化常漏掉的一步
安装脚本（如 .pkg 或 .msi）通常只改 /etc/paths 或注册全局 PATH，但 zsh/bash 的 ~/.zshrc 或 ~/.bash_profile 里没自动加 export PATH=$PATH:/usr/local/go/bin。结果是：新终端打不开 Go，但 iTerm 里已开的 tab 还能用（因为继承了旧环境）。解决方法：
执行 echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc（macOS Catalina 及以后默认 zsh），然后 source ~/.zshrc；Linux 用户注意对应自己的 shell 配置文件（~/.bashrc 或 ~/.profile）。
Windows 上 PowerShell 和 CMD 环境变量不同步
PowerShell 默认不读取 Windows 系统级 PATH 的用户变量，且它的 $env:PATH 是 session 级的。常见现象：go version 在 CMD 里正常，PowerShell 里报 “无法识别”。不要用 [Environment]::SetEnvironmentVariable 写注册表——太重。更轻量的做法是：
- 在 PowerShell 里临时加：
$env:PATH += ";C:\Program Files\Go\bin" - 如需永久生效，在 PowerShell 中运行：
[System.Environment]::SetEnvironmentVariable('PATH', $env:PATH + ';C:\Program Files\Go\bin', 'User') - 然后重启 PowerShell（不是仅
source），再验证go env GOROOT
真正麻烦的是 WSL2：它用的是 Linux 子系统，和 Windows 的 PATH 完全隔离，必须单独在 ~/.bashrc 里导出 /mnt/c/Program\ Files/Go/bin（注意空格转义），且路径要用 /mnt/c/... 格式，不能用 C:\。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
