Ubuntu下Golang环境配置方法

Ubuntu 下 Golang 环境配置方法

一 安装方式概览

• 使用 APT 仓库安装：简单稳定，适合快速上手与服务器环境，版本通常为发行版维护的较新稳定版。
• 官方二进制包安装：版本可控、可并行多版本，适合需要特定版本或升级频繁的开发场景。
• 版本管理工具 GVM：便于在同一台机器上安装、切换多个 Go 版本，适合开发与测试多版本兼容。

二 方式一 APT 仓库安装

• 更新索引并安装：
  • sudo apt update
  • sudo apt install golang-go
• 验证安装：
  • go version
• 说明：
  • APT 安装的 Go 可执行文件通常位于 /usr/bin/go，GOROOT 常见为 /usr/lib/go；环境变量可能已由包管理器部分设置，必要时可在 ~/.bashrc 或 ~/.profile 中补充或调整。上述路径与验证方式在 Ubuntu 22.04 等版本中均适用。

三 方式二 官方二进制包安装

• 下载与解压（以 go1.19.3.linux-amd64.tar.gz 为例，可按需替换为最新版本）：
  • wget https://golang.google.cn/dl/go1.19.3.linux-amd64.tar.gz
  • sudo tar -C /usr/local -xzf go1.19.3.linux-amd64.tar.gz
• 配置环境变量（写入 ~/.bashrc 或 ~/.profile）：
  • export GOROOT=/usr/local/go
  • export GOPATH=$HOME/go
  • export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
  • 使配置生效：source ~/.bashrc（或 source ~/.profile）
• 验证安装：
  • go version
• 说明：
  • 官方二进制包解压到 /usr/local/go，将 $GOROOT/bin 加入 PATH 后即可全局使用 go 命令。

四 方式三 使用 GVM 管理多版本

• 安装 GVM：
  • bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
• 安装与切换版本（示例）：
  • gvm install go1.18.3
  • gvm use go1.18.3 --default
• 验证安装：
  • go version
• 说明：
  • GVM 会在用户目录下管理多个 Go 版本，适合需要快速切换版本的开发与测试场景。

五 验证与常用配置

• 基础验证与模块代理：
  • 查看版本：go version
  • 查看环境：go env
  • 配置国内模块代理（加速下载）：go env -w GOPROXY=https://goproxy.cn,direct
• 快速测试程序：
  • 创建 main.go：
    • package main
    • import “fmt”
    • func main() { fmt.Println(“Hello, world!”) }
  • 运行与构建：
    • go run main.go
    • go build -o helloworld && ./helloworld
• 常见问题与提示：
  • 若 go 命令不可用，检查 PATH 是否包含 $GOROOT/bin 与 $GOPATH/bin。
  • 使用模块时，Go 1.11+ 默认启用 Go Modules，无需额外设置 GO111MODULE（仅在需要时显式设置）。