Install Golang on Ubuntu Guide – wiki基地

作者： /

Ubuntu上安装和配置Golang的详细指南

Go语言（Golang）是Google开发的一种静态强类型、编译型语言，以其高效的并发模型、简洁的语法以及强大的标准库而闻名，被广泛应用于网络服务、分布式系统、云基础设施等领域。对于想要在Ubuntu操作系统上进行Go语言开发的新手或经验丰富的开发者来说，正确地安装和配置Go环境是迈出第一步的关键。

本文将为您提供一份详细的Ubuntu上安装和配置Go语言环境的指南，涵盖了多种安装方法、环境变量设置以及基础的使用验证。

1. 前言：选择适合您的安装方法

在Ubuntu上安装Go有几种常见的方法，每种方法都有其优缺点：

  1. 使用APT包管理器安装： 这是Ubuntu中最标准、最简单的方法。它通过Ubuntu的官方软件仓库进行安装和管理，更新方便。但缺点是仓库中的Go版本可能不是最新的稳定版。适合希望快速上手且对Go版本要求不那么严格的用户。
  2. 从官方下载tarball并手动安装： 这是从Go官方网站直接下载预编译的二进制文件进行安装的方法。优点是可以获取到最新的Go版本，并且可以灵活地选择安装位置。缺点是需要手动进行环境配置（设置环境变量），更新也需要手动操作。适合需要最新Go版本或希望完全掌控安装过程的用户。
  3. 使用第三方工具（如Snap、goenv）： Snap是Ubuntu的一种应用打包和分发系统，提供了易于安装和隔离的软件包。goenv是一个Go版本管理工具，类似于nvm或pyenv，可以方便地在不同Go版本之间切换。这些方法提供了额外的便利性或灵活性，但对于初学者来说，通常建议先掌握前两种基础方法。

本文将重点介绍前两种最常用、最基础的安装方法，并详细讲解环境配置。

2. 准备工作

在开始安装之前，请确保您具备以下条件：

  • 一台运行Ubuntu操作系统的计算机（推荐使用LTS长期支持版本，如Ubuntu 20.04 LTS或 22.04 LTS）。
  • 互联网连接，用于下载必要的软件包或安装文件。
  • 一个具有sudo权限的用户账户。
  • 基本的终端或命令行操作知识。

3. 方法一：使用APT包管理器安装Go

这种方法是最推荐给大多数Ubuntu用户的，因为它简单且易于维护。

步骤 3.1：更新包列表

在安装任何新软件之前，总是一个好习惯先更新一下本地的包索引，确保您能安装到仓库中最新的可用版本信息。

打开终端，输入以下命令：

bash
sudo apt update

输入您的用户密码（输入时不会显示字符），然后按回车键。系统会连接到Ubuntu的软件仓库，下载最新的包列表。

步骤 3.2：安装Golang

包列表更新完成后，您就可以使用apt命令安装Go语言了。在终端中输入：

bash
sudo apt install golang-go

系统会提示您确认安装以及需要下载和占用的磁盘空间。输入 Y 并按回车键继续。apt会自动处理Go及其依赖项的下载和安装过程。

步骤 3.3：验证安装

安装完成后，您可以通过运行Go命令来验证安装是否成功以及查看安装的Go版本。

在终端中输入：

bash
go version

如果安装成功，您应该会看到类似以下的输出，显示安装的Go版本号（具体版本号取决于您的Ubuntu版本及其软件仓库）：

go version goX.Y.Z linux/amd64

例如：go version go1.18.1 ubuntu1 或 go version go1.20.4 linux/amd64。

APT安装的优点：

  • 安装过程简单，只需几条命令。
  • 易于通过 sudo apt upgrade 命令进行更新。
  • 由Ubuntu仓库维护，稳定性较高。

APT安装的缺点：

  • 仓库中的Go版本可能不是Go官方发布的最新版本。对于需要最新特性或特定版本的开发者来说，这可能是一个限制。

如果您对Go的版本要求不高，或者只需要一个稳定的开发环境，APT安装是最好的选择。

4. 方法二：从官方下载tarball并手动安装Go

这种方法允许您安装Go官方发布的最新版本，并更灵活地控制安装位置。

步骤 4.1：访问Go官方下载页面

打开浏览器，访问Go官方下载页面：https://golang.org/dl/ 或其中国镜像站点（如 https://golang.google.cn/dl/，在国内可能访问更快）。

在该页面上，找到适用于Linux系统的最新版本的二进制文件（通常是 .tar.gz 格式）。例如，goX.Y.Z.linux-amd64.tar.gz。复制该文件的下载链接。

步骤 4.2：下载Go安装包

打开终端，使用 wget 或 curl 命令下载安装包。将 <下载链接> 替换为您在步骤 4.1 中复制的实际链接。

使用 wget：

bash
wget <下载链接>

或者使用 curl：

bash
curl -O <下载链接>

例如，如果您要下载 Go 1.21.5 版本：

bash
wget https://golang.org/dl/go1.21.5.linux-amd64.tar.gz

等待下载完成。

步骤 4.3（推荐）：验证下载文件的完整性

下载完成后，为了确保文件没有在下载过程中损坏或被篡改，强烈建议验证其SHA256校验和。在下载页面上，每个下载链接旁边都会提供相应的校验和。

在终端中，使用 sha256sum 命令计算下载文件的校验和：

bash
sha256sum goX.Y.Z.linux-amd64.tar.gz

将 goX.Y.Z.linux-amd64.tar.gz 替换为您下载的实际文件名。命令会输出一长串字符。将这个输出与下载页面上提供的SHA256校验和进行比对，如果一致，则文件完整且未被篡改。

步骤 4.4：删除之前的Go安装（如果存在）

如果您之前通过手动方式安装过Go，最好先将其删除，以免冲突。默认情况下，手动安装的Go通常位于 /usr/local/go。

bash
sudo rm -rf /usr/local/go

如果您不确定Go是否已安装或安装在哪里，可以跳过此步骤，或者在后续配置PATH时注意不要重复添加。

步骤 4.5：解压安装包到目标位置

将下载的tarball文件解压到您想要安装Go的位置。通常推荐将其安装到 /usr/local 目录下。

使用 tar 命令解压：

bash
sudo tar -xzf goX.Y.Z.linux-amd64.tar.gz -C /usr/local/

这里的选项解释：
* sudo：以管理员权限运行，因为 /usr/local 通常需要root权限才能写入。
* tar: 解压命令。
* -x: 解压。
* -z: 使用gzip解压。
* -f: 指定要解压的文件。
* goX.Y.Z.linux-amd64.tar.gz: 您下载的Go安装包文件名。
* -C /usr/local/: 指定解压的目标目录为 /usr/local/。解压后，Go的文件将位于 /usr/local/go 目录下。

步骤 4.6：配置Go环境变量 (PATH)

为了能够在任何目录下都能方便地运行 go 命令，您需要将Go的二进制文件路径（/usr/local/go/bin）添加到系统的 PATH 环境变量中。

编辑您的shell配置文件。如果您使用的是Bash（Ubuntu的默认shell），文件通常是 ~/.bashrc。如果您使用的是Zsh，文件通常是 ~/.zshrc。使用您喜欢的文本编辑器打开文件，例如 nano 或 vim：

“`bash

如果您使用 Bash

nano ~/.bashrc

如果您使用 Zsh

nano ~/.zshrc
“`

在文件的末尾添加以下行：

bash
export PATH=$PATH:/usr/local/go/bin

这行命令的作用是将 /usr/local/go/bin 目录添加到现有的 PATH 变量后面。$PATH 代表原有的PATH路径，: 是路径分隔符。

保存并关闭文件。在nano中，按 Ctrl+X，然后按 Y 确认保存，再按回车键退出。

步骤 4.7：使环境变量生效

您需要重新加载shell配置文件，或者关闭并重新打开终端窗口，以使刚刚修改的环境变量生效。

在当前的终端中，您可以运行以下命令立即加载：

“`bash

如果您修改了 ~/.bashrc

source ~/.bashrc

如果您修改了 ~/.zshrc

source ~/.zshrc
“`

步骤 4.8：验证安装

现在，Go的环境变量已经设置好了，您可以验证Go是否能够正常运行。

在终端中输入：

bash
go version

这次，您应该看到您手动安装的Go版本号：

go version goX.Y.Z linux/amd64

手动安装的优点：

  • 可以安装最新版本的Go。
  • 完全控制安装位置。

手动安装的缺点：

  • 安装步骤相对复杂，需要手动下载、解压和配置环境变量。
  • 更新Go版本需要重复大部分手动安装的步骤。

5. 理解和配置Go工作空间（GOPATH）

在Go Module（Go 1.11+ 引入的模块管理系统）出现之前，GOPATH 是Go语言最重要的环境变量之一。它定义了Go项目的源代码、编译后的二进制文件和第三方包的存放位置。

在 Go Module 时代：

Go Module 改变了项目的组织方式，项目不再必须放在 GOPATH 下。Go Module 项目可以在文件系统的任何位置。依赖包也不再直接存放在项目的 vendor 目录或全局 GOPATH 下，而是通常缓存在一个全局的模块缓存目录中（由 GOMODCACHE 环境变量指定，默认是 GOPATH/pkg/mod）。

尽管如此，GOPATH 环境变量仍然有其作用：

  • 存储通过 go install 安装的命令： 如果您使用 go install <module@version> 命令安装 Go 工具或应用程序，它们通常会被安装到 GOPATH/bin 目录下。为了方便运行这些命令，您仍然需要将 GOPATH/bin 添加到系统的 PATH 环境变量中。
  • 存储旧版 Go 项目或遗留工具： 一些旧的项目或工具可能仍然依赖传统的 GOPATH 结构。
  • 作为模块缓存的默认位置： 如上所述，GOMODCACHE 默认在 GOPATH/pkg/mod。

配置 GOPATH：

虽然现在不是强制要求将 您的项目代码 放在 GOPATH 下，但设置一个 GOPATH 仍然是推荐的，尤其对于存储通过 go install 安装的工具。默认的 GOPATH 位置是 $HOME/go。您可以手动设置它，或者接受默认值。

如果接受默认值 $HOME/go，您只需要确保 $HOME/go/bin 在您的系统 PATH 中。如果您想自定义 GOPATH 位置（例如 /path/to/your/go/workspace），则需要在shell配置文件中设置它。

例如，设置 GOPATH 为 $HOME/go 并将其 bin 目录添加到 PATH：

编辑 ~/.bashrc 或 ~/.zshrc 文件，在之前添加的 export PATH 行的 后面 添加以下行：

“`bash

设置 GOPATH 为用户主目录下的 go 目录

export GOPATH=$HOME/go

将 GOPATH 的 bin 目录添加到 PATH 中

export PATH=$PATH:$(go env GOPATH)/bin
“`

$(go env GOPATH) 会在运行时获取当前设置的 GOPATH 的值，从而构建正确的 bin 路径。

保存并关闭文件，然后重新加载 shell 配置文件：

“`bash

如果您修改了 ~/.bashrc

source ~/.bashrc

如果您修改了 ~/.zshrc

source ~/.zshrc
“`

创建 GOPATH 目录（如果不存在）：

如果您设置了 GOPATH 并且该目录尚不存在，您需要手动创建它：

bash
mkdir -p $GOPATH

-p 选项会递归创建目录，即使父目录不存在也会一并创建。

6. 验证Go环境设置

配置好环境后，除了 go version，您还可以使用 go env 命令来查看Go环境的详细信息，包括 GOROOT (Go安装目录，通常会自动设置)、GOPATH 以及其他相关变量。

bash
go env

检查输出中的 GOROOT 是否指向您的Go安装目录（/usr/local/go 或 APT 安装的位置），以及 GOPATH 是否设置为您期望的值 ($HOME/go 或您自定义的路径)。确认 PATH 变量中包含了 $GOROOT/bin 和 $GOPATH/bin。

7. 编写并运行一个简单的Go程序 (“Hello, World!”)

现在Go已经安装并配置好了，让我们来编写一个简单的“Hello, World!”程序，以最终验证环境是否工作正常。

步骤 7.1：创建项目目录

在您喜欢的位置创建一个新的目录用于存放Go项目，例如在您的主目录下：

bash
mkdir ~/golang_projects
cd ~/golang_projects

步骤 7.2：创建Go源文件

使用您喜欢的文本编辑器创建一个名为 main.go 的文件：

bash
nano main.go

在文件中输入以下Go代码：

“`go
package main

import “fmt”

func main() {
fmt.Println(“Hello, World! Go is installed on Ubuntu!”)
}
“`

代码解释：
* package main: 定义程序所在的包。main 包是可执行程序的入口包。
* import "fmt": 导入 fmt 包，用于格式化输入和输出，包括打印文本到控制台。
* func main(): 这是程序执行的入口函数。程序从这里开始运行。
* fmt.Println(...): 调用 fmt 包中的 Println 函数，将字符串输出到标准输出（控制台）。

保存并关闭 main.go 文件。

步骤 7.3：运行程序

在终端中，进入到您创建的项目目录（如果不在的话）：

bash
cd ~/golang_projects

使用 go run 命令直接运行源代码文件：

bash
go run main.go

如果一切正常，您应该在终端看到输出：

Hello, World! Go is installed on Ubuntu!

go run 命令是Go提供的一个便捷工具，它会编译并运行指定的Go源文件。

步骤 7.4：构建可执行文件（可选）

您也可以使用 go build 命令将源代码编译成一个可执行文件。

bash
go build

该命令会在当前目录下生成一个与目录同名的可执行文件（在本例中通常是 golang_projects 或 main，取决于Go版本和模块设置）。

您可以通过运行这个可执行文件来执行程序：

bash
./golang_projects # 或者 ./main，取决于生成的文件名

同样，您应该会看到 “Hello, World! Go is installed on Ubuntu!” 的输出。

通过编写和运行这个简单的程序，您已经成功验证了Go环境的安装和基本配置。

8. 更新Go版本

通过APT安装的更新：

如果您通过APT安装了Go，更新非常简单，就像更新其他系统软件一样：

bash
sudo apt update
sudo apt upgrade

如果Ubuntu仓库中有更新版本的Go，upgrade 命令会自动为您更新。

通过手动tarball安装的更新：

如果您是手动安装的Go，更新意味着下载新版本的tarball，然后重复安装步骤 4.2 到 4.8：

  1. 访问Go官网下载最新版本的tarball。
  2. 下载新的tarball。
  3. （可选但推荐）验证校验和。
  4. 删除旧的Go安装目录（sudo rm -rf /usr/local/go）。
  5. 解压新的tarball到 /usr/local/ （sudo tar -xzf new_go_tarball.tar.gz -C /usr/local/）。
  6. 验证新版本 (go version)。您之前设置的环境变量应该仍然有效。

9. 卸载Go

通过APT安装的卸载：

要通过APT卸载Go，使用以下命令：

bash
sudo apt remove golang-go

如果您还想删除相关的配置文件（虽然Go的APT包通常不保留重要的用户配置），可以使用 purge：

bash
sudo apt purge golang-go

通过手动tarball安装的卸载：

手动卸载Go需要删除安装目录和清除相关的环境变量设置。

  1. 删除Go安装目录（如果安装在 /usr/local/go）：

    bash
    sudo rm -rf /usr/local/go

  2. 编辑您的shell配置文件（~/.bashrc 或 ~/.zshrc），删除或注释掉之前添加的关于 GOROOT (如果您手动设置了)、GOPATH 和将 $GOROOT/bin 或 $GOPATH/bin 添加到 PATH 的行。

  3. 重新加载shell配置文件或重启终端。

10. 故障排除

在安装和配置过程中，您可能会遇到一些问题：

  • go: command not found： 这通常意味着Go的二进制文件路径没有正确添加到系统的 PATH 环境变量中。请仔细检查步骤 4.6 和 4.7，确保 /usr/local/go/bin（或Go实际安装位置的bin目录）被添加到了 PATH 中，并且您已经重新加载了shell配置文件或重启了终端。如果您使用APT安装，请确认安装过程没有报错。
  • go version 显示的版本不是我期望的版本：
    • 如果您使用了APT和手动安装两种方法，可能APT安装的版本在PATH中优先于手动安装的版本。检查您的 PATH 环境变量，echo $PATH，看看哪个路径先出现。确保您期望的Go版本的 bin 目录在其他Go bin目录之前。
    • 如果您只使用了一种方法，可能是安装或环境变量设置有误。重新检查相应的安装步骤。
  • Permission denied： 当您尝试执行需要root权限的操作（如解压到 /usr/local）时，确保使用了 sudo。当您尝试运行 go build 或 go run 时遇到权限问题，检查您的项目目录是否有当前用户的读写执行权限。
  • 下载慢或失败： 尝试使用国内的Go镜像下载站点（如 golang.google.cn/dl/）或者检查您的网络连接。

如果遇到其他问题，可以查阅Go官方文档、Go社区论坛或Stack Overflow等资源，通常能找到解决方案。

11. 总结

本文详细介绍了在Ubuntu操作系统上安装和配置Go语言环境的两种主要方法：使用APT包管理器和从官方tarball手动安装。同时，解释了Go环境变量（尤其是 GOPATH）的作用及其在Go Module时代的变化，并提供了验证安装、编写运行简单程序、更新和卸载Go的步骤。

无论是选择简单的APT安装，还是灵活的手动安装，掌握Go环境的正确配置是顺利进行Go语言开发的基石。希望这篇详细指南能帮助您成功在Ubuntu上搭建起Go开发环境，祝您在Go语言的学习和开发旅程中一切顺利！

现在，您可以开始编写您的第一个Go程序，探索Go的强大功能了！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部