Linux下安装Go及环境配置教程

本文详细介绍了在Linux系统上通过官方二进制包安装Go语言的完整流程，强调其比系统包管理器更可靠——可避免版本陈旧、命令缺失或GOPATH行为异常等问题；涵盖下载解压（推荐/usr/local/go路径）、精准配置GOROOT/PATH/GOPATH三大环境变量、验证安装、初始化module及运行Hello World的实操步骤，并直击“command not found: go”“GOROOT为空”“cannot find module”等高频错误根源，尤其提醒必须将$GOPATH/bin加入PATH才能正常使用go install生成的命令，是一份兼顾原理、细节与排错的实用指南。

Go 语言在 Linux 上安装不依赖系统包管理器也能完成，但直接用官方二进制包最稳妥——避免发行版仓库中版本过旧、缺少 go 命令或 GOPATH 默认行为异常等问题。

下载并解压官方二进制包

去 https://go.dev/dl/ 找最新稳定版的 linux-amd64.tar.gz（ARM 机器选 linux-arm64.tar.gz），然后执行：

wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz

注意：tar -C 必须指定绝对路径，且建议覆盖到 /usr/local/go ——这是 go 工具链默认查找位置；若解压到别处（如 $HOME/go），后续必须设 GOROOT，否则 go version 可能报错或显示旧版本。

配置环境变量（关键三行）

把下面三行加到 ~/.bashrc 或 ~/.zshrc 末尾（根据你用的 shell）：

export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin
export GOPATH=$HOME/go

然后运行 source ~/.bashrc（或对应文件）生效。验证是否成功：

go version    # 应输出类似 go version go1.22.5 linux/amd64
go env GOPATH # 应显示 $HOME/go

常见错误：command not found: go 多因 PATH 没加对，或 shell 配置文件没重载；go env GOROOT 显示空值说明 GOROOT 未设或设错。

初始化模块并测试 hello world

新建项目目录，初始化 module（Go 1.16+ 默认启用 module，不推荐再用 GOPATH/src 旧方式）：

mkdir ~/hello && cd ~/hello
go mod init hello

写个 main.go：

package main
import "fmt"
func main() {
    fmt.Println("Hello, Go")
}

运行：go run main.go。如果报错 cannot find module providing package fmt，说明 GOROOT 错了，go 没找到标准库。

真正容易被忽略的是：go install 默认把编译后的二进制放到 $GOPATH/bin，而这个路径必须也在 PATH 中才能直接运行命令——很多人只加了 $GOROOT/bin 却漏了这一条。

今天关于《Linux下安装Go及环境配置教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！