跳过正文
  1. 文章/

Go环境配置(Linux)

750 字

这份教程采用 Go 官方推荐的目录结构,全程适配 Zsh 终端(.zshrc),步骤清晰可直接复制执行。

前置说明(规范路径)
#

环境变量路径作用
GOROOT~/.go/goGo 语言本身的安装目录(存放二进制、标准库),仅存放 Go 官方文件
GOPATH~/goGo 工作区,存放你的项目源码、编译后的包、go install 安装的可执行文件
GOBIN~/go/bin专门存放 go install 生成的可执行程序,已加入系统 PATH

分步操作教程
#

步骤 1:创建规范的目录结构
#

先创建 Go 安装目录和工作区目录,确保层级清晰:

# 创建 GOROOT 目录(存放 Go 安装文件)
mkdir -p ~/.go
# 创建 GOPATH 工作区(bin=可执行文件、pkg=编译包、src=项目源码)
mkdir -p ~/go/{bin,pkg,src}
# 进入 Go 安装目录,准备下载安装包
cd ~/.go

步骤 2:下载 Go 1.26 安装包
#

下载适配 Ubuntu amd64 架构的 Go 1.26 安装包(二选一即可):

# 方式 1:使用 wget 下载(推荐,大部分 Ubuntu 预装)
wget https://go.dev/dl/go1.26.0.linux-amd64.tar.gz

# 方式 2:如果没有 wget,用 curl 下载
curl -LO https://go.dev/dl/go1.26.0.linux-amd64.tar.gz

步骤 3:解压安装包到 GOROOT
#

将下载的压缩包解压到 ~/.go 目录(会自动生成 ~/.go/go 目录,即 GOROOT):

# 先删除旧版本(如有)
sudo rm -rf ~/.go/go
# 解压到 ~/.go 目录(-C 指定解压根目录)
tar -C ~/.go -xzf go1.26.0.linux-amd64.tar.gz

步骤 4:配置 Zsh 环境变量
#

将 Go 环境变量写入 ~/.zshrc(Zsh 终端的配置文件),确保永久生效:

# 追加环境变量配置到 .zshrc,使用 'EOF' 避免变量转义
cat >> ~/.zshrc <<'EOF'
# Go 1.26 环境变量(官方规范配置)
export GOROOT=$HOME/.go/go
export GOPATH=$HOME/go
export GOBIN=$GOPATH/bin
export PATH=$GOROOT/bin:$GOBIN:$PATH
EOF

步骤 5:生效环境变量
#

让刚配置的 .zshrc 立即生效(无需重启终端):

source ~/.zshrc

如果没有使用zsh,把步骤4和步骤5中的.zshrc替换成.bashrc即可

步骤 6:验证安装是否成功
#

执行以下命令,检查 Go 环境是否配置正确:

# 1. 检查 Go 版本(应输出 go version go1.26.0 linux/amd64)
go version

# 2. 检查 GOROOT 路径(应输出 /home/你的用户名/.go/go)
echo $GOROOT

# 3. 检查 GOPATH 路径(应输出 /home/你的用户名/go)
echo $GOPATH

# 4. 检查 PATH 中是否包含 GOBIN(应能看到 ~/go/bin 路径)
echo $PATH | grep $GOBIN