Linux下安装配置Go语言环境教程

真正装好Go环境远不止`go version`能运行那么简单——必须同时满足`go`命令可执行、`go mod init`能生成`go.mod`、`go run`能成功运行Hello World这三大硬性条件，缺一不可；系统包管理器安装的旧版Go（如Ubuntu 22.04的1.18或CentOS 7的1.11）不仅缺失泛型约束、embed等关键特性，还因GOROOT路径混乱、PATH优先级错误及默认无代理导致模块拉取频繁超时，极易在项目初始化或构建阶段崩溃；正确做法是手动下载官方二进制包，严格设置`GOROOT=/usr/local/go`并确保`$GOROOT/bin`置于`PATH`最前端，再强制配置国内可用的`GOPROXY=https://goproxy.cn,direct`，最后通过从空目录完整走通`go mod init → go build → go run`闭环验证，才算真正落地可用。

为什么不能直接用 apt install golang 或 yum install golang

系统包管理器里的 golang 版本普遍滞后：Ubuntu 22.04 自带 go1.18，CentOS 7 是 go1.11，而当前稳定版已是 go1.23.10。go1.18 不支持泛型约束（type T interface{ ~int | ~string }），go1.21 以上才默认启用 embed 和更严格的模块校验。项目 go.mod 里声明 go 1.22，旧版 go 直接报错退出。

• 用 apt/yum 安装后，which go 返回的是 /usr/bin/go，但官方二进制解压后是 /usr/local/go/bin/go —— 若没把后者放在 PATH 开头，go version 看似正常，实际调用的仍是旧版
• 某些 CI 工具（如 GitHub Actions 的 ubuntu-latest）默认预装旧版 go，不显式覆盖会导致构建失败
• 系统包安装的 GOROOT 通常设为 /usr/lib/go，与官方文档和 IDE 预期不符，部分调试插件会误判路径

GOROOT 和 PATH 必须成对设置且顺序不能错

手动解压后，/usr/local/go 就是真实安装路径。必须显式声明 GOROOT，并确保 $GOROOT/bin 在 PATH 最前面：

• 写入 ~/.bashrc 或 ~/.zshrc（别写错 shell）：
  export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
• 不要写成 export PATH=$PATH:$GOROOT/bin —— 这会让系统自带的 /usr/bin/go 优先被调用
• 改完立刻 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，几秒内完成即通
• 若仍超时，检查是否设置了公司防火墙白名单，或临时换用 https://proxy.golang.org 测试网络连通性

验证必须走完整闭环：从空目录开始 go mod init → go build → go run

很多环境看似“能跑”，一建项目就报 go: cannot find main module 或 build failed: no Go files in，本质是模块初始化失败或工作目录权限不对。

• 真实可用的标准操作：
  mkdir ~/tmp-go-test && cd ~/tmp-go-test
go mod init test
cat > main.go <
package main
import "fmt"
func main() { fmt.Println("OK") }
EOF
go run main.go
• 如果报 cannot find main module，说明当前目录不在模块根下，或 go.mod 没生成成功
• 如果报 no Go files in，检查 main.go 是否真在当前目录，且文件编码不是 UTF-16/带 BOM
• 如果 go build 生成二进制但运行时报 permission denied，确认目标目录有写权限（比如不要在 /root 下普通用户执行）