装好Go不等于能写代码，必须同时满足go命令可用、go mod init能生成go.mod、go run能跑通Hello World；系统包管理器安装的Go版本滞后（如Ubuntu 22.04为go1.18，而当前稳定版是go1.25.2），不支持泛型约束、embed等新特性，且存在PATH路径冲突、GOROOT不一致、CI构建失败等问题；正确做法是手动下载官方二进制包，严格配置GOROOT和PATH（$GOROOT/bin必须在PATH最前），并务必设置GOPROXY=https://goproxy.cn,direct以确保依赖下载成功。
装好 Go 不等于能写代码，真正能干活要同时满足三件事：go 命令可用、go mod init 能生成 go.mod、go run 能跑通 Hello World。只跑通 go version，90% 的人会在拉依赖或编译时卡死。
为什么不能直接 apt install golang 或 yum install golang
系统包管理器里的 Go 版本严重滞后：Ubuntu 22.04 自带 go1.18，CentOS 7 是 go1.11，而当前稳定版已是 go1.25.2（2026 年 7 月）。旧版不支持泛型约束（如 type T interface{ ~int | ~string }），go1.21+ 才默认启用 embed 和模块校验。项目 go.mod 里声明了 go 1.24，旧版 go 直接报错退出。
更隐蔽的问题是路径冲突：
-
apt安装的go在/usr/bin/go，官方二进制解压后是/usr/local/go/bin/go - 若没把后者放在
PATH最前面，which go看似正常，实际调用的仍是旧版 - 某些 CI（如 GitHub Actions 的
ubuntu-latest）默认预装旧版，不显式覆盖会构建失败 - 系统包安装的
GOROOT通常是/usr/lib/go，和官方文档、IDE 预期不符，部分调试插件会误判路径
手动解压 + 正确配置 GOROOT 和 PATH
下载官方 .tar.gz 包（Linux/macOS）或 .msi（Windows），解压到 /usr/local/go（Linux/macOS）或 D:\Go（Windows，**路径不能含中文、空格、特殊符号**）。
立即学习“go语言免费学习笔记（深入）”；
关键配置必须成对且顺序严格：
- 在
~/.zshrc（macOS/Linux）或系统环境变量（Windows）中写入： export GOROOT=/usr/local/go-
export PATH=$GOROOT/bin:$PATH—— 注意是$GOROOT/bin在前，绝不能写成$PATH:$GOROOT/bin - 改完立刻
source ~/.zshrc（或重启终端） - 验证：
echo $PATH应看到/usr/local/go/bin出现在最左；which go必须返回/usr/local/go/bin/go
如果用 sudo su - 切换 root 后 go 找不到，是因为 root 没加载你的 shell 配置；需单独为 root 配置，或改用 /etc/profile.d/go.sh（systemd、crontab 只读这个）。
不配 GOPROXY 就等于没装成功
go version 成功 ≠ 能干活。只要涉及 go mod download、go get 或 go run 自动拉依赖，没代理就会卡住，错误只有 dial tcp: i/o timeout，完全不提示代理问题。
国内用户务必执行：
-
go env -w GOPROXY=https://goproxy.cn,direct——direct表示对私有仓库（如公司内网 Git）跳过代理，必须保留 - 验证是否生效：新建空目录，执行
go mod init example.com/test→go get github.com/sirupsen/logrus，几秒内完成即通 - 若仍超时，检查是否设置了公司代理或防火墙策略
最容易被忽略的是：模块初始化后，go.mod 里声明的 Go 版本必须与本地 go 版本一致；go run 报错 “go version mismatch” 时，不是代码问题，而是版本不匹配。别急着重装，先查 go version 和 cat go.mod | grep go。
