官方推荐直接下载 tar.gz 包解压至 /usr/local/go 并配置 GOROOT 和 PATH；须匹配系统架构，禁用包管理器安装，多版本共存应使用符号链接切换，go install 须以普通用户执行。
直接下载官方 tar.gz 包解压即可使用，无需编译或系统级安装 —— 这是 Go 官方推荐的部署方式，也是最稳定、最易回滚的做法。
从官网下载对应平台的 go*.tar.gz 包
去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 找最新稳定版（如 go1.22.5.linux-amd64.tar.gz），注意匹配你的操作系统和 CPU 架构：
-
linux-amd64：64 位 x86 Linux（常见服务器） -
linux-arm64：ARM64 服务器（如 AWS Graviton、树莓派 4+） -
darwin-arm64：Apple Silicon Mac（M1/M2/M3） -
darwin-amd64：Intel Mac（已逐步淘汰） - Windows 用户应选
go*.windows-amd64.msi（图形安装器）或go*.windows-amd64.zip（免安装 ZIP）
不要用包管理器（如 apt install golang 或 brew install go）部署生产环境 —— 系统源里的版本通常滞后，且 GOROOT 路径不明确，容易和本地开发环境冲突。
解压到 /usr/local 并配置 GOROOT
Go 的设计原则是“一个 GOROOT 对应一个 Go 安装”，官方包默认期望被解压到 /usr/local/go。执行：
立即学习“go语言免费学习笔记（深入）”；
sudo rm -rf /usr/local/go sudo tar -C /usr/local -xzf go*.tar.gz
然后在 shell 配置文件（~/.bashrc、~/.zshrc 或系统级 /etc/profile.d/go.sh）中添加：
export GOROOT=/usr/local/go export PATH=$GOROOT/bin:$PATH
注意点：
- 必须设置
GOROOT，否则go env GOROOT可能返回空或错误路径，影响交叉编译和工具链定位 - 不要把
$GOROOT/bin放在PATH中间 —— 它必须优先于其他 Go 安装（比如用户目录下的~/go/bin） - 如果已有旧版 Go，先确认
which go和go version是否指向预期路径，避免残留符号链接干扰
验证安装并区分 GOPATH 与 GOBIN
运行以下命令确认基础可用性：
go version go env GOROOT GOPATH GOBIN
输出中 GOROOT 应为 /usr/local/go；GOPATH 默认是 $HOME/go（可不改），但要注意：
-
go install命令生成的二进制默认放在$GOPATH/bin，不是$GOROOT/bin - 若想统一管理安装的工具（如
gopls、sqlc），建议显式设置GOBIN：export GOBIN=$HOME/bin export PATH=$GOBIN:$PATH
这样所有go install结果都落在$HOME/bin，便于清理和版本隔离 - Go 1.16+ 默认启用
GO111MODULE=on，不再依赖GOPATH/src存放项目源码 —— 新项目直接在任意路径go mod init即可
多版本共存与权限问题避坑
生产服务器常需多个 Go 版本（如 v1.19 兼容旧项目，v1.22 用于新服务）。不建议覆盖 /usr/local/go，而应：
- 解压到版本化路径，例如：
/usr/local/go1.19、/usr/local/go1.22 - 用符号链接切换：
sudo ln -sf /usr/local/go1.22 /usr/local/go
再重载PATH - 避免用
sudo go install—— 这会把二进制写入$GOROOT/bin，破坏只读安装包结构；始终用普通用户权限运行go install - 如果遇到
permission denied错误，检查/usr/local/go所有者是否为root:root，且权限为755；子目录不应有777或write权限给组/其他用户
真正麻烦的从来不是安装本身，而是后续谁动了 GOPATH、谁改了 PATH 顺序、谁在 CI 脚本里硬编码了 /usr/local/go/bin/go 却没验证版本 —— 把 go version 和 go env 加进部署前检查清单，比任何文档都管用。
