在Linux系统中搭建Golang开发环境,需要先完成安装包下载、解压安装,再配置对应的环境变量,最后验证环境是否可用,整个过程操作并不复杂,按照步骤执行即可顺利完成。

一、下载Golang安装包
首先需要根据自己的Linux系统架构选择对应的安装包,常见的架构有amd64和arm64,可以通过uname -m命令查看系统架构。之后到Golang官方下载页面获取对应版本的安装包,这里以amd64架构的1.21.0版本为例,使用wget命令下载:
# 查看系统架构 uname -m # 下载Golang安装包 wget https://dl.ipipp.com/dl/go/go1.21.0.linux-amd64.tar.gz
二、解压安装Golang
下载完成后,将安装包解压到/usr/local目录下,这个路径是Linux系统下常用的软件安装路径,后续配置环境变量也会用到这个路径:
# 解压安装包到/usr/local目录 sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
解压完成后,可以在/usr/local目录下看到go文件夹,这就是Golang的安装目录,对应环境变量中的GOROOT路径。
三、配置环境变量
Golang需要配置两个核心环境变量:GOROOT和GOPATH,同时需要将Golang的可执行文件路径添加到系统的PATH变量中。环境变量可以配置在当前用户的环境变量文件中,比如~/.bashrc或者~/.zshrc,根据自己使用的shell选择对应的文件即可。
1. 编辑环境变量文件
使用文本编辑器打开对应的环境变量文件,这里以~/.bashrc为例:
# 编辑bashrc文件 vim ~/.bashrc
2. 添加环境变量配置
在文件末尾添加以下内容,其中GOPATH可以自定义为自己喜欢的路径,用来存放Go项目的源码和依赖:
# 配置GOROOT,指向Golang的安装目录 export GOROOT=/usr/local/go # 配置GOPATH,自定义Go项目的工作目录 export GOPATH=$HOME/go # 将Golang的bin目录添加到PATH export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
3. 生效环境变量
保存文件后,执行以下命令让环境变量生效:
# 使环境变量配置生效 source ~/.bashrc
四、验证安装是否成功
环境变量生效之后,可以通过go version命令查看Golang的版本,确认安装是否成功:
# 查看Golang版本 go version
如果输出类似go version go1.21.0 linux/amd64的内容,说明Golang已经安装成功。还可以执行go env命令查看所有环境变量的配置情况,确认GOROOT和GOPATH是否和之前配置的一致。
五、测试运行Go程序
为了进一步确认环境可用,可以编写一个简单的Go程序进行测试。在GOPATH的src目录下创建一个测试文件:
// 测试程序,输出hello golang
package main
import "fmt"
func main() {
fmt.Println("hello golang")
}
保存文件为test.go,然后执行以下命令运行程序:
# 运行测试程序 go run test.go
如果输出hello golang,说明整个Golang环境配置完成,可以正常开发Go项目了。
常见问题说明
- 如果执行go命令提示找不到命令,一般是PATH环境变量没有配置正确,需要检查
/usr/local/go/bin是否添加到了PATH中。 - 如果GOPATH路径下没有自动生成bin、pkg、src等目录,可以手动创建,这些目录分别用来存放可执行文件、依赖包和项目源码。
- 如果需要安装多个Golang版本,可以使用go version manager之类的版本管理工具,避免手动切换环境变量出现混乱。