答案是PATH未正确配置导致shell找不到go命令。根本原因是官方二进制包解压后go可执行文件位于/usr/local/go/bin/go，但该路径未加入PATH环境变量；需确认shell类型，编辑对应配置文件（如~/.zshrc），添加export PATH=$PATH:/usr/local/go/bin并source生效。
直接装官方二进制包，别用 apt install golang 或 yum install golang —— 版本太旧（比如 Ubuntu 24.04 自带的还是 go1.21，而当前稳定版已是 go1.22.5），且路径不标准，后续 go install、gopls、CI 脚本全可能出问题。
为什么 go 命令始终报 command not found
90% 是因为 PATH 没生效或写错了位置：
- 检查
echo $PATH输出里是否含/usr/local/go/bin；没有就说明export PATH=...没起作用 - 确认你编辑的是当前 shell 正在用的配置文件：
~/.bashrc（bash）、~/.zshrc（zsh）、或/etc/profile.d/go.sh（系统级服务需要） -
source ~/.bashrc必须在**同一终端窗口**执行；新开终端才自动加载，但当前窗口不会“自动刷新” - 别把
export PATH=...写在注释行后面，也别漏掉$PATH:导致覆盖原有路径（应写export PATH=$PATH:/usr/local/go/bin，不是export PATH=/usr/local/go/bin）
GOROOT 到底要不要手动设置
Go 1.10+ 能自动推断 GOROOT（只要 go 命令本身在 /usr/local/go/bin/go 这种标准路径下），但显式声明仍是强烈建议的：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 某些 IDE（如 VS Code 的 Go 扩展）和构建工具（如 Bazel）会读取
GOROOT，不设可能 fallback 到错误路径 - 运行
go env -w GOROOT=/usr/local/go比改 shell 配置更可靠（它写入$HOME/go/env，对所有 shell 生效） - 如果
go env GOROOT输出为空或错（比如/home/user/go），说明安装路径混乱，得重装 - 千万别用软链接做
/usr/local/go → ~/go：Go 工具链会因路径解析失败而找不到runtime包
配置 GOPATH 和模块代理的实操要点
GOPATH 在模块时代已不用于放项目代码，但它仍控制两件事：缓存位置和 go install 输出目录。国内用户还必须配代理：
立即学习“go语言免费学习笔记（深入）”；
- 默认
$HOME/go可继续用，但确保目录存在：mkdir -p $HOME/go/{bin,src,pkg} - 执行
go env -w GOPATH=$HOME/go（比写 shell 文件更稳，尤其多用户环境） - 国内务必设代理，否则
go mod download或go install会卡死：go env -w GOPROXY=https://goproxy.cn,direct -
GOBIN不强制设，但如果你常跑go install（比如装gopls），建议单独指定：go env -w GOBIN=$HOME/go/bin，并确保该路径也在PATH中 - 验证闭环：
go mod init test && go get rsc.io/quote@v1.5.2 && go run main.go—— 这三步全通才算真可用
最容易被忽略的是：go env -w 写的配置优先级高于 shell 文件，且会持久化到 $HOME/go/env；如果某天发现环境变量“莫名变了”，先看这里，而不是反复改 .bashrc。
