必须手动安装官方 Go 二进制包（如 go1.22.5.linux-amd64.tar.gz）至 /usr/local/go，禁用系统包管理器；配置 GOROOT、GOPATH 和 PATH；启用模块模式并设置 GOPROXY=https://goproxy.cn,direct。
直接用系统包管理器安装的 Go 版本通常过旧（如 Ubuntu 22.04 自带 go1.18），不支持泛型、embed 等现代特性，也不匹配项目 go.mod 中声明的 go 1.21+ 要求。必须手动安装二进制分发版。
下载并解压官方 Go 二进制包
从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 获取对应架构的 tar.gz 包（如 go1.22.5.linux-amd64.tar.gz），避免使用 apt install golang 或 dnf install golang —— 它们无法升级到最新稳定版。
- 下载后解压到
/usr/local：wget https://www.php.cn/link/81836b7cd16991abb7febfd7832927fdgo1.22.5.linux-amd64.tar.gz sudo rm -rf /usr/local/go sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz
- 确保不覆盖已有
/usr/local/go下的自定义修改（极少见，但若存在需先备份） - ARM64 服务器（如 AWS Graviton）请选
linux-arm64.tar.gz，否则运行go version会报cannot execute binary file: Exec format error
配置 GOPATH 和 PATH 环境变量
GOPATH 不再决定模块路径（Go 1.11+ 默认启用 module 模式），但它仍影响 go install 生成的可执行文件存放位置；PATH 必须包含 /usr/local/go/bin 才能全局调用 go 命令。
- 编辑
/etc/profile.d/golang.sh（对所有用户生效）：export GOROOT=/usr/local/go export GOPATH=$HOME/go export PATH=$GOROOT/bin:$GOPATH/bin:$PATH
- 立即生效：
source /etc/profile.d/golang.sh - 验证：
go version应输出go version go1.22.5 linux/amd64；go env GOPATH应为/home/username/go - 不要把
GOPATH设为/usr/local/go—— 这会干扰GOROOT，导致go build找不到标准库
验证模块模式与代理设置（国内必需）
中国大陆服务器直连 proxy.golang.org 基本超时，不设代理会导致 go mod download 卡住或失败，进而使 go run、go build 无法拉取依赖。
立即学习“go语言免费学习笔记（深入）”；
- 启用 Go Module 并设置国内代理：
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct
- 确认生效：
go env GOPROXY输出应含goproxy.cn；go env GO111MODULE应为on - 临时绕过代理（仅调试）：
export GOPROXY=direct，但生产环境严禁长期使用 - 若项目含私有 Git 仓库（如公司内网 GitLab），需在
GOPROXY后追加https://git.example.com并配GOINSECURE
真正容易被忽略的是：即使 go version 显示正确，若未运行 go env -w GOPROXY=...，后续任何依赖操作都可能静默失败——错误常表现为 go: github.com/some/pkg@v1.2.3: reading https://proxy.golang.org/...: dial tcp: i/o timeout，而非明确报错退出。
