必须使用官方二进制包手动安装并精准配置GOROOT与PATH，确保go命令唯一来自$GOROOT/bin，同时设置GOPATH并将其bin目录加入PATH，以避免旧版残留、路径冲突及go install失效等问题。
Go 环境搭建不是“选一套方案凑合用”，而是必须避开几个硬性雷区：GOPATH 误配导致模块找不到、GOROOT 与 PATH 冲突引发 go 命令失效、旧版本残留干扰新安装。选官方二进制包 + 手动配置路径，是唯一能同时满足确定性、可复现性和跨平台一致性的做法。
为什么不用包管理器（如 Homebrew / apt）自动装？
包管理器常滞后于 Go 官方最新稳定版（比如当前最新是 go1.22.0，Homebrew 可能还卡在 go1.21.6），且会把 GOROOT 指向非标准路径（如 macOS 上的 /opt/homebrew/Cellar/go/1.21.6/libexec），后续调试 go build 或交叉编译时容易因路径不一致报错。更麻烦的是，apt 安装的 Ubuntu 版本常绑定系统发行版周期，升级困难。
GOROOT 和 PATH 怎么配才不冲突？
关键点只有一条：确保 PATH 中的 go 可执行文件**唯一来自 GOROOT/bin**，而不是其他路径（比如之前装过的旧版本、第三方 SDK 目录）。实操建议：
- 先运行
which go，如果输出不是/usr/local/go/bin/go（Linux/macOS）或C:\Go\bin\go.exe（Windows），说明有残留； - 删掉所有旧 Go 安装目录，再清空
PATH中所有含go字样的路径段； -
GOROOT必须显式设为解压后的根目录（如/usr/local/go），不能省略； -
PATH只追加$GOROOT/bin，不要硬编码路径——否则换机器就失效。
为什么现在还要管 GOPATH？
Go 1.11+ 默认启用 module 模式，GOPATH 不再是模块查找路径，但它仍是 go install 安装可执行文件的默认目标（即 $GOPATH/bin）。如果你用 go install github.com/xxx/cli@latest，生成的二进制就放这儿。所以：GOPATH 仍需设置，但只需保证其 bin 子目录在 PATH 中即可，不必像老版本那样把项目全放进去。
立即学习“go语言免费学习笔记（深入）”；
真正容易被忽略的细节是：Windows 用户若用 PowerShell，$env:PATH 追加后必须重启终端才生效；Linux/macOS 用户改完 ~/.bashrc 或 ~/.zshrc 后，得手动 source，否则 go version 仍报 command not found。
