macOS 上用 Homebrew 装 Go 最省事：brew install go 自动配置 PATH 和 GOROOT，无需手动修改 ~/.zshrc；验证需运行 go version、go env GOPROXY、go mod init + go get、go run main.go 四步。
macOS 上用 Homebrew 装 Go 最省事
如果你用的是 macOS，brew install go 是最快、最不容易出错的方式。Homebrew 会自动把 go 二进制文件放进 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），并默认纳入 shell 的 PATH，多数情况下你连 ~/.zshrc 都不用改。
常见错误现象：command not found: go —— 多半是终端没重载配置，或者你用了非默认 shell（比如 fish）。别急着加 export PATH，先运行 which go 看有没有输出；没输出再查 brew --prefix，然后手动补上对应路径。
- Homebrew 安装后，
go version能立刻返回结果才算成功 - 不需要手动设
GOROOT：Homebrew 版 Go 自带正确路径，设了反而可能冲突 -
go mod默认启用，GOPATH已非必需，但建议仍保留$HOME/go作为个人工具存放目录（比如go install的命令会落到$GOPATH/bin）
Windows 用户直接装 .msi 包，别碰 ZIP 手动解压
Windows 上最稳妥的路径就是下载官网的 .msi 安装包，双击安装。它会自动把 C:\Go\bin 加进系统 PATH，还会设好 GOROOT，基本零配置。
容易踩的坑：go 命令在 PowerShell 里能用，CMD 却提示“不是内部或外部命令”——这是环境变量没刷到 CMD 进程里。关掉所有 CMD 窗口，重新打开即可；不要尝试在 CMD 里执行 refreshenv 或手动改注册表。
立即学习“go语言免费学习笔记（深入）”；
- 安装时勾选 “Add Go to PATH”（新版安装器默认已勾）
- 验证时用
go version，不是go --version（后者不识别） - 如果后续要用
go install，确保%USERPROFILE%\go\bin在PATH中（.msi 默认不加，需手动补）
Linux 用户优先用系统包管理器，而非 tar.gz
Ubuntu/Debian 用 sudo apt install golang-go，CentOS/RHEL 用 sudo dnf install golang。这些包由发行版维护，和系统 libc、TLS 库兼容性更好，升级也走统一通道。
手动解压 tar.gz 到 /usr/local/go 看似“官方推荐”，实则容易翻车：比如某些 Alpine 镜像缺少 ca-certificates，导致 go mod download 直接失败；又或者 GOROOT 指向错误路径，go build 报 cannot find package "fmt"。
- 确认安装后
go env GOROOT输出是否指向实际安装路径（如/usr/lib/go） - 避免混用多个 Go 来源：卸载旧版再装新包，别让
/usr/local/go/bin/go和/usr/bin/go同时存在 - 若必须用 tar.gz，请用
sudo tar -C /usr/local -xzf go.tar.gz，且务必运行source ~/.profile（不是~/.bashrc）来加载系统级 PATH
验证环境是否真可用，不止看 go version
go version 只说明二进制存在，不代表模块、网络、编译链全通。真正验证得跑三步：
- 执行
go env GOPROXY：应返回https://proxy.golang.org,direct或国内镜像（如https://goproxy.cn），为空就可能卡在go mod download - 新建空目录，运行
go mod init test，再go get github.com/gorilla/mux@v1.8.0：能成功拉下依赖才说明代理和 TLS 正常 - 写个最小
main.go：package main; func main() { println("ok") }，然后go run main.go：能打印 ok 才代表 runtime 和 linker 没问题
复杂点在于：网络代理、公司防火墙、DNS 污染这三者经常叠加出问题，而错误信息往往只显示 timeout 或 no such file or directory，看不出根源。这时候别硬试，先 curl -v https://proxy.golang.org 看底层连通性。
