首先安装go二进制包并解压至/usr/local,然后配置PATH和GOPATH环境变量,接着验证go version与go env GOPATH,再编写hello.go程序测试运行,最后解决常见问题如命令未找到、权限不足及模块代理缓慢,确保开发环境正常。

在ubuntu系统中搭建golang开发环境并不复杂,只要按照标准流程操作,基本可以快速完成配置。下面详细介绍安装步骤及常见问题的解决方法。
安装Go语言环境
Ubuntu系统推荐使用官方二进制包安装Go,确保版本最新且稳定。
wget https://www.php.cn/link/81836b7cd16991abb7febfd7832927fdgo1.22.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.linux-amd64.tar.gz
立即学习“go语言免费学习笔记(深入)”;
- 这会将Go安装到
/usr/local/go目录下
配置环境变量
为了让系统识别go命令,需要设置PATH等环境变量。
nano ~/.bashrc
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bashrc
验证安装是否成功
运行以下命令检查Go是否正确安装:
go version
如果输出类似go version go1.22 linux/amd64,说明安装成功。
再测试环境变量:
go env GOPATH
应返回你的~/go目录路径。
编写第一个Go程序测试
创建一个简单程序验证开发环境是否可用。
- 新建项目目录并进入:
mkdir ~/hello && cd ~/hello
hello.go文件:
nano hello.go
package main
import “fmt”
func main() {
fmt.Println(“Hello, Ubuntu Go!”)
}
go run hello.go
若输出Hello, Ubuntu Go!,表示环境已准备就绪。
常见问题与解决方法
在安装和配置过程中,可能会遇到一些典型问题。
- 命令未找到:go: command not found
检查PATH是否包含/usr/local/go/bin,确认配置文件已正确加载 - 权限不足导致解压失败
确保使用sudo执行tar命令,或改用用户目录安装 - 模块代理问题导致下载缓慢或失败
国内用户建议设置国内代理:
go env -w GOproxy=https://goproxy.cn,direct
确保
$GOPATH/src、bin、pkg存在,或使用Go Modules避免依赖传统结构
基本上就这些。只要按步骤操作,Ubuntu上搭建Go开发环境非常顺利。遇到问题优先检查环境变量和网络代理设置,多数情况都能快速解决。