最稳妥的linux go安装方式是下载官网二进制包解压至/usr/local；需显式配置goroot和path（$goroot/bin必须在path开头）；必须设置goproxy=https://goproxy.cn,direct并验证go mod init→build→run全流程成功。

直接装官方二进制包，别碰 apt install golang

Linux 上装 Go，最稳妥的方式就是去官网下 go1.22.5.linux-amd64.tar.gz（ARM64 机器选 linux-arm64.tar.gz），解压到 /usr/local。系统包管理器装的 Go 通常版本老旧——Ubuntu 22.04 自带 go1.18，不支持泛型、embed，也跑不动声明了 go 1.21 的项目。

• 用 wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz 下载（注意不是 php.cn 那种跳转链接，用 go.dev 官方直链更稳）
• 执行 sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz，强制覆盖旧安装，避免残留干扰
• 验证：运行 /usr/local/go/bin/go version，能输出就说明文件本身没问题

GOROOT 和 PATH 必须显式配对，顺序不能错

GOROOT 不设也能跑，但 IDE、CI 或某些构建脚本会误判路径；而 PATH 里如果把 /usr/bin/go 这类系统自带路径放在前面，go version 看起来正常，实际调用的却是旧版本。

• 写入 ~/.zshrc 或 ~/.bashrc（别写错 shell）：
  export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
• 必须把 $GOROOT/bin 放在 $PATH 开头，不是末尾
• 改完后 source ~/.zshrc，再检查：echo $PATH 要看到 /usr/local/go/bin，which go 要返回这个路径

国内用户不设 GOPROXY 就等于没装成功

go version 成功 ≠ 能干活。只要涉及 go mod download、go run 或任何依赖拉取，没代理就会卡在 dial tcp: i/o timeout，错误信息里甚至不提代理的事，只报网络超时。

• 立刻执行：go env -w GOPROXY=https://goproxy.cn,direct
• 顺便加固：go env -w GO111MODULE=on（虽 1.16+ 默认开启，但显式设上防 CI 环境误判）
• 验证：go env GOPROXY 输出应含 goproxy.cn；go mod init test && go get rsc.io/quote 能秒完成才算真正通了

验证别只跑 go version，要闭环测试 go mod init → build → run

很多环境看似“装好了”，一建项目就报 go: cannot find main module 或 build failed: no Go files in，其实是模块初始化或路径权限问题。真实可用的标准是：从空目录开始，三步全通。

• 新建临时目录：mkdir -p /tmp/gotest && cd /tmp/gotest
• 写最简程序：echo 'package main; import "fmt"; func main() { fmt.Println("ok") }' > main.go
• 闭环执行：go mod init gotest && go build -o hello . && ./hello，输出 ok 且无报错才算过关

最容易被忽略的是：系统级服务（如 systemd）、crontab、CI 流水线默认不读 ~/.zshrc，若需在这些场景用 go，得把环境变量写进 /etc/profile.d/go.sh 并确保 GOROOT 是绝对路径、不含软链接。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！