Go 语言 Ubuntu 安装与配置方法

2025-4-15

Ubuntu 系统下 Go 语言安装与配置终极指南

Go 语言（通常称为 Golang）是由 Google 设计开发的一种静态强类型、编译型、并发型，并具有垃圾回收功能的编程语言。凭借其简洁的语法、出色的并发处理能力、高效的性能以及强大的标准库，Go 语言在云计算、微服务、网络编程、分布式系统、命令行工具等领域获得了广泛应用。Ubuntu 作为最受欢迎的 Linux 发行版之一，是 Go 语言开发的理想平台。本指南将详细介绍在 Ubuntu 系统上安装和配置 Go 语言开发环境的多种方法，并涵盖环境验证、基础配置以及常见问题处理，旨在帮助开发者顺利开启 Go 语言之旅。

1. 引言：为什么选择 Go 和 Ubuntu？

Go 语言的优势：
- 并发性： Go 语言原生支持并发，通过 Goroutines 和 Channels 机制，可以轻松编写高并发、高性能的程序，充分利用现代多核处理器的能力。
- 性能： Go 是编译型语言，直接编译成机器码，执行效率高，接近 C/C++ 的性能，同时避免了 C/C++ 的复杂性。
- 简洁与高效： 语法设计简洁明了，学习曲线相对平缓。其强制的代码格式化工具 (gofmt) 保证了代码风格的一致性，提高了开发和协作效率。
- 强大的工具链： Go 语言自带强大的工具链，包括编译、测试、格式化、依赖管理等，开箱即用。
- 静态链接： Go 程序可以编译成单个静态链接的可执行文件，不依赖外部库，部署极为方便。
- 活跃的社区与生态： 拥有庞大且活跃的开发者社区，以及丰富的第三方库和框架。
Ubuntu 的优势：
- 广泛使用： 作为桌面和服务器市场占有率极高的 Linux 发行版，拥有良好的硬件兼容性和庞大的用户基础。
- 易用性： 用户界面友好，软件包管理系统 (APT) 成熟稳定，安装和管理软件非常便捷。
- 强大的社区支持： 遇到问题时，可以轻松在网络上找到解决方案和帮助文档。
- 稳定性与安全性： 特别是 LTS (长期支持) 版本，提供了长期的安全更新和维护，适合开发和生产环境。

在稳定、易用且资源丰富的 Ubuntu 系统上搭建 Go 开发环境，无疑是开发者们的理想选择。

2. 准备工作

在开始安装 Go 之前，请确保满足以下基本条件：

一台运行 Ubuntu 的计算机： 推荐使用较新的 LTS 版本（如 20.04, 22.04 或更高版本）。
终端访问权限： 你需要能够打开并使用命令行终端。
sudo 权限： 大部分安装和配置步骤需要管理员权限。
网络连接： 用于下载 Go 安装包和依赖。
基本的 Linux 命令行知识： 熟悉 cd, ls, mkdir, sudo, apt 等基本命令。

建议在开始安装前更新你的系统包列表：

bash sudo apt update sudo apt upgrade -y

3. Go 语言安装方法

有多种方法可以在 Ubuntu 上安装 Go 语言。我们将详细介绍最常用的三种方法：

方法一：使用 Ubuntu 官方 APT 包管理器安装 (最简单，但可能不是最新版本)

这是最简单直接的方法，利用 Ubuntu 自带的 apt 包管理器进行安装。

步骤：

打开终端。
执行安装命令：

bash sudo apt update sudo apt install golang-go
apt 会自动处理依赖关系并安装 Go 语言环境。
验证安装： 安装完成后，可以通过以下命令检查 Go 的版本：

bash go version
如果看到类似 go version go1.XX.X linux/amd64 的输出，则表示安装成功。

优点：

简单快捷： 只需一条命令即可完成安装。
易于管理： 可以通过 apt 进行更新和卸载，与其他系统软件统一管理。

缺点：

版本可能滞后： Ubuntu 官方仓库中的 Go 版本通常会落后于 Go 官方发布的最新稳定版。如果你需要使用最新的语言特性或修复，这种方法可能不适用。

适用场景： 对 Go 版本没有严格要求，或者只是初步学习和体验 Go 语言的开发者。

方法二：从 Go 官方网站下载二进制发行版安装 (推荐，可获取最新版本)

这种方法允许你安装 Go 官方发布的最新稳定版本，并且对安装位置有更多控制权。这是大多数开发者推荐的方式。

步骤：

访问 Go 官方下载页面： 打开浏览器，访问 https://go.dev/dl/ 或 https://golang.google.cn/dl/ (国内镜像)。
选择并下载 Linux 版本： 找到适用于 Linux 的最新稳定版 Go 二进制文件（通常是 go<VERSION>.linux-amd64.tar.gz 格式，例如 go1.22.1.linux-amd64.tar.gz）。你可以右键复制下载链接。
使用 wget 或 curl 下载： 打开终端，切换到你希望存放下载文件的目录（例如 ~/Downloads），然后使用 wget 或 curl 下载。将 <DOWNLOAD_LINK> 替换为你复制的链接。

```bash

使用 wget

cd ~/Downloads
wget

或者使用 curl

cd ~/Downloads
curl -LO
*示例（假设最新版是 1.22.1）：*bash
wget https://go.dev/dl/go1.22.1.linux-amd64.tar.gz
```
(可选但推荐) 验证文件完整性： 官方下载页面会提供文件的 SHA256 校验和。下载完成后，使用 sha256sum 命令计算本地文件的校验和，并与官网提供的值进行比对，确保文件未被篡改且下载完整。

bash sha256sum go<VERSION>.linux-amd64.tar.gz
将输出的哈希值与官网上的进行核对。
移除旧的 Go 安装（如果存在）： 为了避免冲突，如果你之前通过其他方式（特别是手动安装在 /usr/local/go）安装过 Go，建议先将其移除。通常 Go 的推荐安装路径是 /usr/local/go。

bash sudo rm -rf /usr/local/go
如果你是通过 apt 安装的，可以使用 sudo apt remove golang-go 卸载。
解压 Go 压缩包到 /usr/local： 这是 Go 官方推荐的安装位置。

```bash

确保你在包含 .tar.gz 文件的目录

将 go.linux-amd64.tar.gz 替换为你下载的文件名

sudo tar -C /usr/local -xzf go.linux-amd64.tar.gz
*示例（假设最新版是 1.22.1）：*bash
sudo tar -C /usr/local -xzf go1.22.1.linux-amd64.tar.gz
`` 执行此命令后，Go 的所有文件将被解压到/usr/local/go` 目录下。
配置环境变量 (PATH)： 这是关键步骤，需要将 Go 的 bin 目录添加到系统的 PATH 环境变量中，这样你才能在任何目录下执行 go 命令。
- 编辑配置文件： 你可以选择修改系统级的 /etc/profile（影响所有用户）或用户级的 ~/.profile、~/.bashrc（如果使用 Bash shell）或 ~/.zshrc（如果使用 Zsh shell）。推荐修改用户级的配置文件 ~/.profile，因为它在登录时加载，并且只影响当前用户。
  使用文本编辑器（如 nano, vim, gedit）打开配置文件：
  bash nano ~/.profile
- 添加 Go 路径： 在文件的末尾添加以下行：
  bash export PATH=$PATH:/usr/local/go/bin
  这一行告诉系统，在查找可执行文件时，也要搜索 /usr/local/go/bin 目录。
- 保存并关闭文件： 在 nano 中，按 Ctrl+X，然后按 Y 确认保存，最后按 Enter。
- 使配置生效： 为了让刚才的修改立即生效，你有两个选择：
  1. 执行 source 命令加载配置文件：
    bash source ~/.profile
    (注意：source ~/.bashrc 可能更常用，如果修改的是 .bashrc 的话。但 .profile 通常在登录时加载，对所有 shell 类型更通用。)
  2. 或者，简单地关闭当前终端窗口，然后重新打开一个新的终端窗口。
验证安装： 在新的终端窗口或执行 source 后的窗口中，再次运行 go version 命令：

bash go version
如果看到你刚刚安装的 Go 版本信息，则表示安装和配置成功。

优点：

版本最新： 可以安装 Go 官方发布的最新稳定版本。
控制灵活： 可以自行决定安装位置（尽管推荐 /usr/local/go）。

缺点：

手动更新： 更新 Go 版本需要重复下载和解压的步骤。
配置稍复杂： 需要手动配置 PATH 环境变量。

适用场景： 需要使用特定 Go 版本（尤其是最新版）的开发者，或者希望更好地控制 Go 安装环境的开发者。这是最常用的方法。

方法三：从源代码编译安装 (高级用户)

这种方法适用于需要对 Go 进行定制化构建，或者希望深入了解 Go 编译过程的开发者，以及 Go 语言本身的贡献者。对于普通开发者来说，通常没有必要使用这种方法。

步骤：

安装依赖： 构建 Go 需要一个 C 编译器（如 GCC）和 Git。

bash sudo apt update sudo apt install build-essential git
获取 Go 源代码： 使用 Git 克隆 Go 官方仓库。

bash git clone https://go.googlesource.com/go ~/go-source cd ~/go-source
检出特定版本（可选）： 如果你想编译特定版本的 Go，可以检出对应的标签。

```bash

查看所有可用标签

git tag -l

检出特定版本，例如 go1.22.1

git checkout go1.22.1
```
如果不检出特定版本，默认将编译最新的开发版本。
执行构建脚本： 进入 src 目录并运行构建脚本。

bash cd src ./all.bash
这个过程会需要一些时间，具体取决于你的机器性能。编译好的 Go 环境会放在 ../bin 目录下 (即 ~/go-source/bin)。
配置环境变量： 类似于方法二，你需要将编译生成的 bin 目录添加到 PATH。假设编译后的 Go 在 ~/go-source。

```bash

编辑 ~/.profile

nano ~/.profile

添加以下行 (替换为你实际的 Go 源码路径)

export PATH=$PATH:$HOME/go-source/bin

保存并 source

source ~/.profile
```
验证安装：

bash go version

优点：

完全控制： 可以定制构建参数，参与 Go 开发。
深入了解： 有助于理解 Go 的内部工作原理。

缺点：

过程复杂： 步骤繁琐，耗时较长。
依赖管理： 需要手动安装构建依赖。
不适合日常开发： 对于仅使用 Go 进行应用开发的场景来说过于复杂。

适用场景： Go 语言开发者、贡献者，或有特殊构建需求的场景。

4. 配置 Go 开发环境

安装完 Go 之后，还需要进行一些基本的环境配置，主要是理解和设置 GOPATH 和 Go Modules。

理解 `GOROOT` 和 `GOPATH`

GOROOT： 指向 Go 语言安装根目录的环境变量。
- 如果你使用方法二将 Go 安装在 /usr/local/go，Go 通常能自动检测到 GOROOT，无需手动设置。
- 如果你安装在其他位置，或者系统无法自动检测，则需要手动设置。例如，在 ~/.profile 中添加：export GOROOT=/path/to/your/go/installation。
- 可以通过 go env GOROOT 命令查看当前生效的 GOROOT。
GOPATH： Go 1.11 版本之前，GOPATH 非常重要，它定义了你的工作空间（Workspace）的根目录。所有非标准库的 Go 源代码、编译后的包文件和可执行文件都存放在 GOPATH 指定的目录下（通常包含 src, pkg, bin 三个子目录）。
- Go Modules 时代的变化： 自 Go 1.11 引入 Go Modules (go mod) 并成为 Go 1.13 及以后版本的默认依赖管理方式后，GOPATH 的重要性大大降低。现在，你的项目可以放在任何位置，不再强制要求放在 $GOPATH/src 下。Go Modules 会在项目根目录下生成 go.mod 和 go.sum 文件来管理依赖。
- GOPATH 的当前作用： 尽管项目位置自由了，GOPATH 仍然有其作用：
  - 全局工具安装目录： 使用 go install 命令安装的全局 Go 工具（例如 linters, debuggers 等）默认会被安装到 $GOPATH/bin 目录下。
  - 缓存目录： Go Modules 的一些缓存数据可能仍然与 GOPATH 相关（尽管主要缓存现在位于 $GOCACHE，默认为 ~/.cache/go-build）。
- 设置 GOPATH： 即使在 Go Modules 时代，设置一个明确的 GOPATH 仍然是好的实践。通常建议将其设置为用户主目录下的 go 文件夹。
  1. 创建 GOPATH 目录（如果不存在）：
    bash mkdir -p ~/go/bin
    （创建 bin 子目录是为了存放 go install 安装的工具）
  2. 编辑 ~/.profile 文件：
    bash nano ~/.profile
  3. 添加 GOPATH 设置，并将其 bin 目录添加到 PATH：
```bash
# 设置 GOPATH
export GOPATH=$HOME/go

将 GOPATH/bin 添加到 PATH，以便直接运行 go install 安装的工具

export PATH=$PATH:$GOPATH/bin
**合并 PATH 设置：** 为了简洁，可以将所有 `PATH` 的修改合并到一行：bash
export GOPATH=$HOME/go
export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin
*(请确保 `/usr/local/go/bin` 与你的 Go 安装路径一致)* 4. 保存文件并使其生效：bash
source ~/.profile
```

Go Modules (`go mod`)

Go Modules 是现代 Go 语言推荐的依赖管理方式。当你创建一个新的 Go 项目时：

在你的项目根目录下（可以在任何位置，例如 ~/projects/my-go-app）：
bash cd ~/projects/my-go-app
初始化 Go Modules：
bash go mod init <module-path>
<module-path> 通常是你的项目代码仓库路径，例如 github.com/yourusername/my-go-app，或者只是项目名 my-go-app。
bash go mod init my-go-app
这会生成一个 go.mod 文件。
当你添加依赖（例如在代码中 import "some/dependency"）并运行 go build, go test, go run 或 go get 时，Go 会自动下载所需的依赖包，并更新 go.mod 和 go.sum 文件。

检查 Go 环境配置

使用 go env 命令可以查看所有 Go 相关的环境变量及其当前值，这对于调试环境问题非常有用：

bash go env

你会看到类似以下的输出（部分）：

GO111MODULE="on" # Go Modules 默认开启 GOARCH="amd64" GOBIN="" # 如果设置了 GOBIN 环境变量，go install 会安装到这里 GOCACHE="/home/user/.cache/go-build" GOENV="/home/user/.config/go/env" GOHOSTARCH="amd64" GOHOSTOS="linux" GOOS="linux" GOPATH="/home/user/go" # 你设置的 GOPATH GOPROXY="https://proxy.golang.org,direct" # 依赖下载代理 GOROOT="/usr/local/go" # Go 安装目录 ...

确保 GOROOT 指向你的 Go 安装目录，GOPATH 指向你设置的工作区目录，并且 GO111MODULE 通常应该是 "on" 或空（默认为 on）。

5. 验证 Go 环境：编写并运行一个简单程序

为了最终确认你的 Go 环境已经完全准备就绪，让我们编写并运行一个经典的 "Hello, World!" 程序。

创建项目目录：
bash mkdir ~/hello-go cd ~/hello-go
初始化 Go Modules：
bash go mod init hello-go
创建 Go 源文件： 使用文本编辑器创建一个名为 main.go 的文件。
bash nano main.go
编写代码： 在 main.go 文件中输入以下内容：

```go
package main

import "fmt"

func main() {
fmt.Println("Hello, Go developers on Ubuntu!")
}
```
保存并关闭文件。
运行程序： 使用 go run 命令直接编译并运行代码：
bash go run main.go
如果你的环境配置正确，你将在终端看到输出：
Hello, Go developers on Ubuntu!
(可选) 编译程序： 使用 go build 命令将代码编译成一个可执行文件：
bash go build
这会在当前目录下生成一个名为 hello-go (与模块名或目录名相同) 的可执行文件。
(可选) 运行可执行文件：
bash ./hello-go
同样会输出 "Hello, Go developers on Ubuntu!"。

如果以上步骤都能顺利完成，恭喜你，你的 Ubuntu Go 开发环境已经成功搭建并配置好了！

6. 管理 Go 版本

随着 Go 语言的不断发展，你可能需要更新到新版本，或者在不同项目中使用不同的 Go 版本。

如果你使用 APT 安装：
- 更新 Go 版本通常通过系统更新完成：
  bash sudo apt update sudo apt upgrade
  但这依赖于 Ubuntu 仓库维护者的更新速度。
- 卸载：
  bash sudo apt remove golang-go sudo apt autoremove
如果你使用官方二进制包手动安装：
- 更新版本： 最直接的方法是重复方法二中的步骤：下载新版本的 .tar.gz 文件，删除旧的 /usr/local/go 目录（sudo rm -rf /usr/local/go），然后将新版本解压到 /usr/local。环境变量配置通常无需更改，因为路径 (/usr/local/go/bin) 保持不变。
- 管理多个版本（进阶）： 如果你需要同时管理多个 Go 版本并在它们之间切换，可以考虑使用 Go 版本管理工具，例如：
  - gvm (Go Version Manager): 类似于 Node.js 的 nvm 或 Ruby 的 rvm。可以让你轻松安装、卸载和切换不同的 Go 版本。安装和使用方法请参考 gvm 的官方文档。
  - goenv: 另一个流行的 Go 版本管理工具，工作方式类似。

7. 集成开发环境 (IDE) 与编辑器

虽然 Go 可以在任何文本编辑器中编写，但使用支持 Go 语言特性的 IDE 或编辑器可以极大地提高开发效率。

Visual Studio Code (VS Code): 非常流行，免费且功能强大。安装官方的 Go 扩展 (golang.go) 后，即可获得语法高亮、智能提示 (IntelliSense)、代码导航、格式化 (gofmt/goimports)、调试、测试、Linting 等全方位支持。该扩展通常会自动提示你安装所需的 Go 工具（如 gopls - Go 语言服务器）。
GoLand: 由 JetBrains 开发的商业 Go IDE，功能非常全面和智能，提供了深度代码分析、重构、调试等高级功能。适合专业 Go 开发者。
Vim / Neovim: 通过插件 (如 vim-go) 可以获得强大的 Go 开发支持。
Emacs: 通过 go-mode.el 和 LSP (Language Server Protocol) 支持也能很好地进行 Go 开发。

配置好你选择的编辑器/IDE 后，开发体验会更加顺畅。

8. 常见问题与故障排除

go: command not found：
- 原因： Go 的 bin 目录没有被正确添加到 PATH 环境变量中，或者环境变量更改后没有生效。
- 解决方案：
  1. 检查你的 ~/.profile (或其他相关配置文件) 是否包含了正确的 export PATH=$PATH:/usr/local/go/bin (根据你的安装路径调整)。
  2. 确保你已经执行了 source ~/.profile 或重新打开了终端。
  3. 运行 echo $PATH 查看当前的 PATH 值，确认 Go 的 bin 目录是否在其中。
  4. 确认 /usr/local/go/bin 目录下确实存在 go 可执行文件。
权限错误 (Permission denied)：
- 原因： 在执行需要 sudo 的命令（如解压到 /usr/local，apt install）时未使用 sudo，或者尝试在没有写权限的目录创建文件或文件夹。
- 解决方案： 确保在需要系统级更改的操作前加上 sudo。检查目录和文件的权限设置 (ls -l)。
GOPATH 或 Go Modules 相关问题：
- 原因： 对 GOPATH 的作用理解不清，或者 Go Modules 未正确初始化。
- 解决方案：
  1. 记住在 Go Modules 时代，项目可以放在任何地方，但必须在项目根目录运行 go mod init <module-path>。
  2. 使用 go env 检查 GOPATH 和 GOROOT 的设置是否符合预期。
  3. 确保 $GOPATH/bin 已经添加到 PATH，以便运行通过 go install 安装的工具。
网络问题（下载 Go 包或依赖失败）：
- 原因： 网络连接不稳定，或者访问 Go 官方源（如 proxy.golang.org）受限（尤其在中国大陆地区）。
- 解决方案：
  1. 检查你的网络连接。
  2. 配置 Go 代理。在中国大陆的开发者可以设置 GOPROXY 环境变量来使用国内镜像：
    bash # 在 ~/.profile 或 ~/.bashrc 中添加 export GOPROXY=https://goproxy.cn,direct # 保存并 source source ~/.profile
    direct 表示如果代理失败，则尝试直接连接。

9. 总结与后续学习

本指南详细介绍了在 Ubuntu 系统上安装和配置 Go 语言开发环境的多种方法，重点推荐了使用官方二进制包进行安装的方式，并解释了 GOROOT, GOPATH, Go Modules 等核心概念的配置。通过验证步骤和 "Hello, World!" 示例，你应该已经拥有了一个可以工作的 Go 开发环境。

成功搭建环境只是第一步。接下来，你可以：

学习 Go 语法： 访问 Go 官方教程 (A Tour of Go) 进行交互式学习。
阅读官方文档： Effective Go 和 Go 标准库文档是深入学习的重要资源。
动手实践： 尝试编写更多小程序，参与开源项目，或者开始你自己的 Go 项目。
探索 Go 生态： 了解流行的 Web 框架（如 Gin, Echo）、ORM（如 GORM）、RPC 框架（如 gRPC）等。

希望本指南能为你顺畅地进入 Go 语言的世界提供坚实的基础。祝你在 Ubuntu 上享受 Go 编程的乐趣！

作者：admin

链接：https://hostlocvps.com/2025/04/15/go-%e8%af%ad%e8%a8%80-ubuntu-%e5%ae%89%e8%a3%85%e4%b8%8e%e9%85%8d%e7%bd%ae%e6%96%b9%e6%b3%95/

文章版权归作者所有，未经允许请勿转载。

THE END

1Panel全面介绍：现代化Linux服务器运维管理面板

<<上一篇

Element Plus 完全上手：配置、组件与实例详解

下一篇>>

Go 语言 Ubuntu 安装与配置方法

Ubuntu 系统下 Go 语言安装与配置终极指南

1. 引言：为什么选择 Go 和 Ubuntu？

2. 准备工作

3. Go 语言安装方法

方法一：使用 Ubuntu 官方 APT 包管理器安装 (最简单，但可能不是最新版本)

方法二：从 Go 官方网站下载二进制发行版安装 (推荐，可获取最新版本)

使用 wget

或者使用 curl

确保你在包含 .tar.gz 文件的目录

将 go.linux-amd64.tar.gz 替换为你下载的文件名

方法三：从源代码编译安装 (高级用户)

查看所有可用标签

检出特定版本，例如 go1.22.1

编辑 ~/.profile

添加以下行 (替换为你实际的 Go 源码路径)

保存并 source

4. 配置 Go 开发环境

理解 GOROOT 和 GOPATH

将 GOPATH/bin 添加到 PATH，以便直接运行 go install 安装的工具

Go Modules (go mod)

检查 Go 环境配置

5. 验证 Go 环境：编写并运行一个简单程序

6. 管理 Go 版本

7. 集成开发环境 (IDE) 与编辑器

8. 常见问题与故障排除

9. 总结与后续学习

理解 `GOROOT` 和 `GOPATH`

Go Modules (`go mod`)