Go安装需严格匹配操作系统、CPU架构与安装方式：Windows优先选.msi（自动配PATH），macOS按arch命令结果选darwin-arm64或amd64，Linux解压后须同时配置GOROOT和$GOROOT/bin到PATH，并执行source生效。
Go 官方安装包下载本身不复杂，但选错版本、用错镜像或忽略系统架构会导致后续 go version 报错、命令不可用，甚至 GOROOT 配置失效。核心原则只有一条：**匹配你的操作系统 + CPU 架构 + 安装方式偏好**。
怎么找对下载地址，避开官网加载失败
Go 官网主下载页 https://go.dev/dl/ 在国内直连常超时或空白。别硬刷，直接换阿里云镜像站——它同步官方所有版本，且无 CDN 限速：
-
https://mirrors.aliyun.com/golang/（推荐，2026 年仍稳定） - 页面按文件名排序，找带
.msi（Windows）、.pkg（macOS）、.tar.gz（Linux）后缀的最新稳定版，例如go1.22.8.windows-amd64.msi - 不要点“Latest stable release”按钮——它跳转的仍是官网，不是镜像
Windows 用户该下 .msi 还是 .zip
绝大多数 Windows 用户应该无脑选 .msi。原因很实际：
-
.msi双击安装后自动把C:\Program Files\Go\bin加进系统PATH，开新终端就能直接用go命令 -
.zip是便携版，解压后需手动配置GOROOT和PATH，稍有遗漏就报'go' is not recognized - 除非你在受限环境（如公司锁死安装权限），否则不用
.zip
macOS 用户必须分清 amd64 和 arm64
苹果芯片已全面转向 ARM 架构，M1/M2/M3 Mac 必须下载 darwin-arm64 包，比如 go1.22.8.darwin-arm64.pkg。装错会遇到两种典型问题：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 安装成功但
go version报Bad CPU type in executable - VS Code 的 Go 扩展提示
Failed to find 'go' binary，因为/usr/local/go/bin/go实际是 x86_64 二进制 - Intel Mac（2019 年及更早）才用
darwin-amd64；不确定型号？终端运行arch，输出arm64就选 arm64 版
Linux 用户解压后 PATH 配置容易漏掉 $GOROOT/bin
Linux 没有图形化安装器，解压 tar -C /usr/local -xzf go*.linux-amd64.tar.gz 后，常见错误是只加了 $PATH:/usr/local/go/bin，却忘了 GOROOT 本身：
- 必须显式声明
export GOROOT=/usr/local/go，否则go env GOROOT可能为空，部分工具链（如go tool dist）会异常 - PATH 要同时包含
$GOROOT/bin和$GOPATH/bin（后者用于本地go install的二进制） - 写进
~/.bashrc后别忘了source ~/.bashrc，否则当前终端不生效
真正卡住人的往往不是下载动作本身，而是下载后没验证架构匹配性，或者 PATH 配置只做了一半。装完立刻跑 go version 和 go env GOROOT，比看教程更重要。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
