如何正确使用 go get 获取并运行 Go 模块（以 gotour 为例）-Golang-PHP中文网

如何正确使用 go get 获取并运行 Go 模块（以 gotour 为例）

霞舞

发布： 2025-09-17 10:52:34

原创

314人浏览过

如何正确使用 go get 获取并运行 Go 模块（以 gotour 为例）

本教程详细阐述了如何使用 go get 命令获取 Go 模块，并解决 gotour 等可执行文件未找到的问题。核心在于理解 GOPATH 环境变量的结构及其 bin 目录的作用，并确保该目录已添加到系统 PATH 中，从而正确运行安装的 Go 程序。

理解 go get 命令的工作原理

go get 是 go 语言工具链中一个非常重要的命令，它用于远程获取、编译并安装 go 模块或包。当您执行 go get <package_path> 时，它会执行以下步骤：

下载源代码： go get 会根据提供的包路径，使用相应的版本控制系统（如 Git、Mercurial 等）从远程仓库下载源代码到您的 $GOPATH/src 目录下。
编译包： 下载完成后，go get 会编译该包及其所有依赖项。编译后的库文件通常存放在 $GOPATH/pkg 目录下。
安装可执行文件： 如果获取的包是一个可执行程序（即其 main 包中包含 main 函数），go get 会将其编译后的可执行文件安装到 $GOPATH/bin 目录下。

因此，当您执行 go get code.google.com/p/go-tour/gotour 这样的命令时，预期的结果是 gotour 这个可执行文件会被放置在 $GOPATH/bin 目录中。

GOPATH 环境变量解析及其重要性

GOPATH 是 Go 语言的工作区，它定义了 Go 项目的根目录。所有通过 go get 下载的第三方库、您自己开发的 Go 项目以及编译后的可执行文件都将存放在 GOPATH 定义的目录结构中。一个典型的 GOPATH 目录结构包含以下三个子目录：

src：存放所有 Go 源代码，包括您自己的项目和通过 go get 下载的第三方库。
pkg：存放编译后的包对象文件（.a 文件），这些文件是为了加速后续编译而生成的。
bin：存放通过 go install 或 go get 安装的可执行程序。

理解 GOPATH/bin 目录的意义至关重要。当一个 Go 程序被编译并安装后，它的可执行文件就位于这个目录。然而，操作系统默认并不知道这个目录的存在，因此您直接在命令行中输入程序名（例如 gotour）时，系统可能无法找到它。

您可以通过 go env GOPATH 命令来查看当前设置的 GOPATH 路径。例如：

$ go env GOPATH
/Users/alex/.golib

登录后复制

将 $GOPATH/bin 添加到系统 PATH

为了让操作系统能够找到并执行 $GOPATH/bin 目录下的程序，您需要将 $GOPATH/bin 添加到系统的 PATH 环境变量中。PATH 环境变量是一个由冒号分隔的目录列表，操作系统在执行命令时会依次搜索这些目录以查找可执行文件。

以下是在不同 Shell 中配置 PATH 环境变量的方法：

1. 对于 Bash 或 Zsh 用户：

打开您的 Shell 配置文件（通常是 ~/.bashrc, ~/.bash_profile, ~/.zshrc 或 ~/.profile），并添加以下行：

export GOPATH=$HOME/go # 建议将GOPATH设置为更易于访问的路径，例如 $HOME/go
export PATH=$PATH:$GOPATH/bin

登录后复制

请注意，您可以根据个人喜好设置 GOPATH。例如，将 GOPATH 设置为 /Users/alex/go 而不是隐藏的 .golib 目录，可以使其更易于管理和访问。

添加后，执行 source ~/.bashrc (或相应的配置文件) 使更改生效。

2. 对于 Fish Shell 用户：

易笔AI论文

专业AI论文生成，免费生成论文大纲，在线生成选题/综述/开题报告等论文模板

103

查看详情

如果您使用 Fish Shell，配置方式略有不同。打开您的 Fish 配置文件（通常是 ~/.config/fish/config.fish），并添加以下行：

set -gx GOPATH $HOME/go # 建议将GOPATH设置为更易于访问的路径，例如 $HOME/go
set -gx PATH $PATH $GOPATH/bin

登录后复制

保存文件后，重新启动 Fish Shell 或执行 source ~/.config/fish/config.fish 使更改生效。

完成上述配置后，您可以通过 echo $PATH 命令来验证 $GOPATH/bin 是否已成功添加到 PATH 中。

运行 gotour

在确保 GOPATH 和 PATH 配置正确无误后，您现在应该可以直接在终端中运行 gotour 命令了。

首先，确保您已经成功执行了 go get code.google.com/p/go-tour/gotour 命令（如果遇到网络错误，如“EOF”，请检查网络连接或确认目标仓库是否可访问）。

然后，在终端中输入：

gotour

登录后复制

如果一切正常，您将看到类似以下的输出：

2012/09/15 10:43:57 Serving content from /Users/alex/go/src/code.google.com/p/go-tour
2012/09/15 10:43:57 Open your web browser and visit http://127.0.0.1:3999/

登录后复制

这表明 gotour 服务已成功启动，并监听在 http://127.0.0.1:3999/。您现在可以在浏览器中访问此地址，开始您的 Go 语言之旅。

GOPATH 设置的最佳实践与注意事项

选择合适的 GOPATH 路径： 建议将 GOPATH 设置为一个非隐藏、易于访问的目录，例如 $HOME/go 或 ~/go-workspace。这将使您更容易管理 Go 项目和工具。
版本控制工具： go get 依赖于版本控制系统来下载源代码。请确保您的系统已安装了相应的工具，例如 git 或 mercurial (hg)。在 Go Modules 模式下，对版本控制工具的依赖有所降低，但对于一些老旧或特定的仓库仍然需要。
go env 命令： go env 是一个非常有用的命令，它可以显示所有 Go 相关的环境变量及其当前值，是诊断环境配置问题的好帮手。
Go Modules (Go 1.11+): 从 Go 1.11 开始，Go Modules 成为官方推荐的依赖管理方式。在 Go Modules 模式下，GOPATH 的作用有所弱化，项目依赖不再强制存放在 GOPATH/src 中，而是存放在项目目录下的 pkg/mod 缓存中。然而，GOPATH/bin 仍然是 go install 命令（在 Go 1.16+ 中推荐用于安装可执行文件）默认的安装路径。因此，将 $GOPATH/bin 添加到 PATH 仍然是最佳实践。

通过遵循本教程的步骤，您将能够有效地使用 go get 获取并运行 Go 模块，为您的 Go 语言学习和开发打下坚实的基础。

以上就是如何正确使用 go get 获取并运行 Go 模块（以 gotour 为例）的详细内容，更多请关注php中文网其它相关文章！