在Linux系统中搭建Golang开发环境是开展Go语言开发的前提，整个过程主要分为官方安装包安装、环境变量配置、安装验证三个核心步骤，同时可以通过专用工具实现多版本灵活管理，适配不同项目的开发需求。
一、Linux下Golang官方安装包安装步骤
1. 下载对应架构的Golang安装包
首先需要根据自己的Linux系统架构选择对应的安装包，常见的架构有amd64和arm64，可以通过uname -m命令查看系统架构。访问Golang官方下载页面获取最新稳定版的安装包链接，然后使用wget命令下载到本地，以下以下载amd64架构的1.21.5版本为例：
# 查看系统架构 uname -m # 下载Golang安装包 wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
2. 解压安装包到指定目录
通常将Golang安装到/usr/local目录下，执行解压命令即可完成安装：
# 解压到/usr/local目录 sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
二、配置Golang环境变量
安装完成后需要配置环境变量，让系统可以识别go命令。需要配置的环境变量主要有GOROOT、GOPATH和PATH，其中GOROOT是Golang的安装目录，GOPATH是Go项目的工作目录，PATH需要添加Golang的bin目录。
1. 编辑环境变量配置文件
如果是当前用户生效，可以编辑~/.bashrc文件，如果是所有用户生效，可以编辑/etc/profile文件，在文件末尾添加以下内容：
# 设置GOROOT为Golang安装目录 export GOROOT=/usr/local/go # 设置GOPATH为工作目录，可根据需求自定义 export GOPATH=$HOME/go # 将Golang的bin目录添加到PATH export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
2. 使环境变量生效
保存配置文件后，执行以下命令让配置生效：
# 如果是编辑的~/.bashrc source ~/.bashrc # 如果是编辑的/etc/profile source /etc/profile
三、验证Golang安装是否成功
环境变量配置完成后，可以通过go命令验证安装是否成功，执行以下命令查看go的版本信息：
go version
如果输出类似go version go1.21.5 linux/amd64的内容，说明Golang已经安装成功。也可以编写一个简单的测试程序验证开发环境是否正常：
package main
import "fmt"
func main() {
fmt.Println("Golang开发环境安装成功")
}
将以上代码保存为test.go，然后执行go run test.go，如果输出Golang开发环境安装成功，说明环境可以正常使用。
四、Linux下Golang版本管理方法
当需要在不同项目中使用不同版本的Golang时，手动切换版本比较繁琐，可以使用gvm（Go Version Manager）工具来管理多个Golang版本。
1. 安装gvm工具
执行以下命令安装gvm：
bash <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
安装完成后执行source ~/.gvm/scripts/gvm让gvm生效。
2. 使用gvm安装和切换Golang版本
gvm支持列出可安装的Golang版本、安装指定版本、切换当前使用的版本等操作，常用命令如下：
- 列出所有可安装的Golang版本：
gvm listall - 安装指定版本的Golang：
gvm install go1.20.12 - 切换当前使用的Golang版本：
gvm use go1.20.12 - 设置默认使用的Golang版本：
gvm use go1.20.12 --default - 列出已安装的Golang版本：
gvm list
3. gvm版本管理注意事项
使用gvm安装Golang时，需要先安装一个引导版本的Go，因为gvm编译新版本Go时需要依赖已有的Go环境。如果安装过程中出现依赖缺失的问题，可以根据提示安装对应的系统依赖，比如gcc、make等编译工具。
五、常见问题排查
在安装和配置过程中可能会遇到一些常见问题，以下是排查方法：
- 执行
go version提示命令不存在：检查环境变量配置是否正确，确认$GOROOT/bin已经添加到PATH中，并且执行了source命令使配置生效。 - 编译Go程序时提示权限不足：检查
GOPATH目录的权限，确保当前用户有读写权限，或者将GOPATH设置为当前用户有权限的目录。 - gvm安装版本失败：检查网络是否正常，或者尝试更换Go安装包的下载源，也可以手动下载安装包后放到gvm的缓存目录中再执行安装命令。
GolangLinuxgo_version环境变量配置版本管理修改时间：2026-06-10 23:06:23