ubuntu用apt装go常出问题，因官方源版本过旧（如22.04默认1.18），不满足项目对1.21+的要求，导致go mod tidy报错；应卸载apt版，改用官方二进制包安装至$home/sdk/go，并正确配置goroot、path、gopath和gobin。
Ubuntu里用apt装Go为什么常出问题
因为Ubuntu官方源的golang包版本太老（比如22.04默认还是1.18），而多数项目要求1.21+，go mod tidy会直接报错go: unsupported Go version。apt装完还得手动覆盖二进制，反而更麻烦。
- 别运行
sudo apt install golang——它装的是系统级Go，路径在/usr/lib/go，和用户环境冲突 - 真正要的是
GOROOT指向你可控的安装目录，不是系统目录 - 如果已误装，先
sudo apt remove golang，再删掉/usr/bin/go软链接（它常指向旧版）
直接下载官方二进制包最稳
去https://go.dev/dl/下最新go1.23.linux-amd64.tar.gz（ARM机器选arm64），解压到$HOME/sdk/go，比用第三方脚本或snap更透明、无副作用。
- 执行：
rm -rf $HOME/sdk/go && tar -C $HOME/sdk -xzf go1.23.linux-amd64.tar.gz - 在
~/.bashrc或~/.zshrc里加两行：export GOROOT=$HOME/sdk/goexport PATH=$GOROOT/bin:$PATH - 重载配置后，
go version必须输出go version go1.23.x linux/amd64，否则PATH顺序错了（比如/usr/bin在$GOROOT/bin前面）
GOBIN和GOPATH现在怎么设
Go 1.16+默认启用module模式，GOPATH只影响go get老式包或go install命令行工具的存放位置；GOBIN则决定这些工具装到哪。不设它们也能跑，但容易混淆。
- 推荐显式设：
export GOPATH=$HOME/go（放依赖源码和构建缓存） - 设
GOBIN避免污染$GOROOT/bin：export GOBIN=$HOME/go/bin - 然后把
$GOBIN加入PATH，且必须放在$GOROOT/bin之后——否则go命令本身可能被覆盖 - 验证：
go install golang.org/x/tools/gopls@latest后，which gopls应输出$HOME/go/bin/gopls
检查PATH和shell配置的隐藏坑
很多问题其实不是Go装错了，而是shell启动时没读对配置文件，或者PATH里混进了其他Go路径（比如Docker Desktop自带的Go、VS Code Dev Container里的Go）。
立即学习“go语言免费学习笔记（深入）”；
- 运行
echo $PATH | tr ':' '\n' | grep go，只允许出现一次$GOROOT/bin和一次$GOBIN，不能有/usr/bin/go或/snap/bin/go - 在新终端里执行
type -a go，第一行必须是go is /home/xxx/sdk/go/bin/go - 如果用zsh但改了
~/.bashrc，记得source ~/.bashrc或把内容挪到~/.zshrc——Ubuntu 22.04+默认用zsh
环境变量一旦写进配置文件，就得关掉所有终端窗口再重开，光source不一定生效（尤其VS Code集成终端会缓存旧环境）。
