linux上如何安装配置golang

在linux系统中部署golang开发环境，需要完成安装包获取、文件解压、环境变量配置、验证安装这几个核心步骤，不同的安装方式适配不同的使用场景，开发者可以根据自身需求选择合适的方法。

安装方式一：官方二进制包安装

这种方式可以安装指定版本的golang，适合需要固定版本的开发场景，步骤如下：

1. 下载官方二进制包

首先到golang官方下载页面获取对应linux架构的安装包，假设我们需要安装go1.21.0版本，64位x86架构的系统可以执行以下命令下载：

# 下载go1.21.0的linux amd64安装包
wget https://dl.ipipp.com/dl/go/go1.21.0.linux-amd64.tar.gz

2. 解压安装包到指定目录

通常将golang解压到/usr/local目录下，执行以下命令：

# 解压到/usr/local目录，解压后会有/usr/local/go目录
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz

3. 配置环境变量

需要配置GOROOT、GOPATH、PATH三个核心环境变量，编辑当前用户的shell配置文件，比如使用bash的用户编辑~/.bashrc，使用zsh的用户编辑~/.zshrc：

# 打开配置文件
vim ~/.bashrc

# 在文件末尾添加以下内容
# 设置GOROOT为go的安装目录
export GOROOT=/usr/local/go
# 设置GOPATH为go的工作目录，可自行修改路径
export GOPATH=$HOME/go
# 将go的bin目录添加到PATH中
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

添加完成后执行以下命令让配置生效：

source ~/.bashrc

安装方式二：包管理器安装

这种方式安装的是系统源中的golang版本，操作更简单，适合不需要指定特定版本的场景，不同linux发行版的命令不同：

Ubuntu/Debian系统

# 更新软件源
sudo apt update
# 安装golang
sudo apt install golang -y

CentOS/RHEL系统

# 安装golang
sudo yum install golang -y

Arch Linux系统

# 安装golang
sudo pacman -S go

通过包管理器安装后，系统会自动配置部分环境变量，但建议还是手动检查并补充GOPATH等配置。

验证安装是否成功

安装完成后可以通过以下两种方式验证：

1. 查看go版本

执行以下命令，如果输出对应的go版本信息，说明安装成功：

go version

2. 运行测试程序

创建一个简单的go程序测试环境是否正常，首先创建hello.go文件：

package main

import "fmt"

func main() {
    // 输出测试内容
    fmt.Println("golang环境配置成功")
}

执行以下命令运行程序：

# 运行go程序
go run hello.go

如果输出golang环境配置成功，说明整个环境可以正常使用。

常见问题排查

• 执行go version提示命令不存在：检查PATH环境变量是否包含$GOROOT/bin，配置文件是否生效，可重新执行source命令。
• 编译程序时提示找不到包：检查GOPATH配置是否正确，第三方包是否安装到$GOPATH/pkg目录。
• 权限问题：解压安装包时如果没有权限，需要加上sudo执行命令，或者将安装目录的权限修改为当前用户。

注意：如果后续需要升级golang版本，二进制包安装方式只需要下载新版本安装包，重复解压覆盖原目录，再更新环境变量即可；包管理器安装方式直接执行对应的升级命令即可。

golanglinuxgo安装环境变量配置修改时间：2026-07-16 05:03:24