Golang macOS Homebrew安装配置详细教程-Golang-PHP中文网

首先运行brew install go安装Go，再设置GOPATH和PATH环境变量，最后验证安装并运行测试程序，即可完成macOS上Go的配置。

golang macos homebrew安装配置详细教程

在macOS上通过Homebrew安装和配置Golang，核心就是运行

brew install go

登录后复制

命令，然后妥善设置好几个关键的环境变量，比如GOPATH，这样就能顺利开始你的Go语言开发之旅了。这个过程通常比你想象的要直接和简单，但一些小细节如果处理得当，能帮你省去不少后续的麻烦和疑惑。

解决方案

首先，确保你的macOS系统上已经安装了Homebrew。如果还没有，打开终端，执行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

登录后复制

安装Homebrew后，就可以开始安装Go了。在终端中输入：

brew install go

登录后复制

Homebrew会为你下载并安装最新稳定版的Go。安装完成后，你可以通过运行

go version

登录后复制

来验证Go是否正确安装，它会显示当前Go的版本信息。

立即学习“go语言免费学习笔记（深入）”；

接下来是环境变量的配置，这部分至关重要。虽然Go Modules的出现让GOPATH的重要性有所下降，但它仍然是Go生态系统不可或缺的一部分，尤其是对于工具链和缓存。

设置GOPATH： 通常，我会将GOPATH设置为用户目录下的一个
```
go
```
登录后复制
文件夹，比如
```
~/go
```
登录后复制
。这个目录会存放你的Go模块缓存、下载的第三方包以及一些通过
```
go install
```
登录后复制
安装的二进制文件。
```
echo 'export GOPATH=$HOME/go' >> ~/.zshrc # 如果你用的是zsh
# 或者 echo 'export GOPATH=$HOME/go' >> ~/.bash_profile # 如果你用的是bash
```
登录后复制
将GOPATH/bin添加到PATH： 为了让系统能够找到通过
```
go install
```
登录后复制
命令编译生成的二进制文件，你需要将
```
$GOPATH/bin
```
登录后复制
添加到系统的PATH环境变量中。
```
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.zshrc # 同样，根据你的shell选择
# 或者 echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bash_profile
```
登录后复制
刷新环境变量： 修改完配置文件后，需要让终端重新加载这些配置，才能使它们生效。
```
source ~/.zshrc # 或者 source ~/.bash_profile
```
登录后复制

现在，你可以尝试创建一个简单的Go程序来测试你的配置。新建一个文件

hello.go

登录后复制

：

package main

import "fmt"

func main() {
    fmt.Println("Hello, Go on macOS with Homebrew!")
}

登录后复制

然后在终端中导航到

hello.go

登录后复制

所在的目录，运行：

go run hello.go

登录后复制

如果一切顺利，你会在终端看到输出

Hello, Go on macOS with Homebrew!

登录后复制

，这说明你的Go环境已经配置成功了。

Homebrew安装Go和官方包安装有什么区别？我应该选择哪种方式？

我个人在macOS上安装Go时，几乎总是倾向于使用Homebrew。这两种安装方式各有优劣，但对于大多数开发者而言，Homebrew的便利性是无与伦比的。

Homebrew安装Go：

优点：
- 管理便捷： Homebrew就像你的macOS应用商店，一条命令
```
brew install go
```
  登录后复制
  就能搞定安装，
```
brew upgrade go
```
  登录后复制
  就能轻松升级，甚至可以方便地切换Go版本（虽然切换版本不常用，但有总比没有好）。
- 集成度高： 它能很好地融入macOS的生态系统，处理依赖关系也更省心。
- 路径清晰： 通常会将Go安装在
```
/usr/local/Cellar/go/<version>
```
  登录后复制
  下，并通过软链接到
```
/usr/local/opt/go
```
  登录后复制
  和
```
/usr/local/bin/go
```
  登录后复制
  ，路径管理非常清晰。
缺点：
- 版本更新： Homebrew上的Go版本可能不会在Google官方发布新版本后立即同步，但通常延迟很小，几乎可以忽略不计。

官方包（.pkg文件）安装Go：

优点：
- 最新版本： 你总是能第一时间从Go官网下载到最新、最原汁原味的Go版本。
- 安装路径固定： 默认安装在
```
/usr/local/go
```
  登录后复制
  ，路径明确。
缺点：
- 手动更新： 每次Go版本更新，你都需要手动下载新的.pkg文件并重新安装，这比较繁琐。
- 版本管理： 没有Homebrew那样方便的版本切换机制。
- 路径配置： 虽然安装器会尝试配置PATH，但有时可能需要你手动检查和调整。

我的建议：

如果你不是那种非要第一时间体验Go的每日构建版本，或者对版本控制有极度特殊要求的开发者，那么Homebrew绝对是你的首选。它极大地简化了安装、升级和管理Go的流程，让你能把更多精力放在代码上，而不是环境配置上。我个人觉得，那种“一键搞定”的体验，真的能省下不少心力。

琅琅配音

全能AI配音神器

208

查看详情

Golang环境变量GOPATH和PATH到底怎么设置才对？有什么需要注意的坑吗？

GOPATH和PATH这两个环境变量，对于初学者来说确实是个容易混淆的地方，我记得我刚开始接触Go的时候也在这上面踩过不少坑。但其实，只要理解它们各自的职责，就会发现它们并没有那么复杂。

GOPATH：

历史作用： 在Go Modules（Go 1.11引入，1.13默认开启）之前，GOPATH是至关重要的。它不仅指定了你的Go项目代码存放的位置，也是Go查找第三方依赖包的唯一路径。所有项目都必须放在GOPATH下的
```
src
```
登录后复制
目录里。
现代作用（Go Modules时代）： 随着Go Modules的普及，你的项目代码不再需要强制放在GOPATH下。你的项目可以放在文件系统的任何位置。然而，GOPATH并没有完全“退休”。它现在主要扮演以下角色：
- 二进制文件存放地： 通过
```
go install
```
  登录后复制
  命令编译安装的二进制可执行文件，默认会存放在
```
$GOPATH/bin
```
  登录后复制
  目录下。
- 模块缓存： Go Modules下载的依赖包的源代码会缓存到
```
$GOPATH/pkg/mod
```
  登录后复制
  目录中。
- 构建缓存： Go的构建缓存也存放在GOPATH下。
如何设置： 我建议将其设置为一个独立且易于管理的目录，例如
```
$HOME/go
```
登录后复制
。
注意的坑：
- 不要将GOPATH设置为你的项目目录！ 这是最常见的错误之一。GOPATH应该是一个独立的、全局的Go工作区，而不是某个具体的项目。
- 理解其角色变化： 很多人以为有了Go Modules，GOPATH就完全没用了，然后就不设置或者随意设置，导致一些工具或命令找不到路径。它只是从“代码存放地”变成了“工具和缓存存放地”。

PATH：

作用： PATH是操作系统用来查找可执行程序的目录列表。当你输入一个命令（比如
```
go
```
登录后复制
或你用Go编译的程序名）时，系统会按顺序在PATH环境变量列出的所有目录中查找这个命令对应的可执行文件。
如何设置： 关键是将Go的安装路径（Homebrew通常会自动处理）以及
```
$GOPATH/bin
```
登录后复制
添加到PATH中。
- Go的安装路径：Homebrew通常会把Go的可执行文件软链接到
```
/usr/local/bin
```
  登录后复制
  ，而这个目录一般已经在你的PATH里了。
- ```
$GOPATH/bin
```
  登录后复制
  ：这个目录需要你手动添加到PATH，这样你通过
```
go install
```
  登录后复制
  安装的各种Go工具或你自己的Go程序才能直接在终端中运行。
注意的坑：
- 没有
  source
  登录后复制
  你的配置文件：修改了
```
.zshrc
```
  登录后复制
  或
```
.bash_profile
```
  登录后复制
  后，如果没有运行
```
source ~/.zshrc
```
  登录后复制
  （或对应文件），新的环境变量是不会生效的。每次打开新终端时，这些配置才会自动加载。
- 编辑了错误的配置文件： macOS默认使用zsh，所以你应该编辑
```
~/.zshrc
```
  登录后复制
  。如果你还在用bash，那就是
```
~/.bash_profile
```
  登录后复制
  。有时用户会混淆。
- PATH顺序问题： 确保
```
$GOPATH/bin
```
  登录后复制
  在PATH中，并且通常放在现有PATH的末尾，避免覆盖系统自带的命令。

要验证你的GOPATH和PATH是否设置正确，可以在终端中分别运行

echo $GOPATH

登录后复制

和

echo $PATH

登录后复制

来查看它们的值。此外，

which go

登录后复制

命令可以告诉你系统正在使用的

go

登录后复制

命令的完整路径。

Go Modules在macOS上如何配合Homebrew安装的Go使用？我还需要关心GOPATH吗？

Go Modules是Go语言官方推荐的依赖管理方式，它彻底改变了Go项目管理依赖的方式，让项目可以脱离GOPATH的束缚，在文件系统的任何位置都能进行开发。在macOS上配合Homebrew安装的Go使用Go Modules，体验和任何其他Go安装方式都是一致的，非常顺畅。

Go Modules概览：

诞生背景： 解决了GOPATH时代版本冲突、依赖管理混乱等问题。
核心文件： 每个使用Go Modules的项目根目录会有一个
```
go.mod
```
登录后复制
文件，它记录了项目的模块路径、Go版本以及所有直接和间接依赖。
```
go.sum
```
登录后复制
文件则记录了所有依赖包的哈希值，用于验证依赖的完整性和安全性。
工作方式： 当你运行
```
go build
```
登录后复制
、
```
go run
```
登录后复制
或
```
go test
```
登录后复制
等命令时，Go会自动根据
```
go.mod
```
登录后复制
文件下载、管理和使用项目所需的依赖。

与Homebrew安装的Go配合使用：

Homebrew安装的Go版本（Go 1.13及以上）默认已经启用了Go Modules。所以，你不需要做任何额外的配置来“启用”它。

初始化一个新模块： 在一个新的项目目录中，运行
```
go mod init <module_path>
```
登录后复制
。
```
<module_path>
```
登录后复制
通常是你的代码仓库地址，例如
```
github.com/yourusername/yourproject
```
登录后复制
。这会生成
```
go.mod
```
登录后复制
文件。
```
mkdir my-module-project
cd my-module-project
go mod init github.com/my/mymodule # 示例模块路径
```
登录后复制
添加依赖： 当你在代码中
```
import
```
登录后复制
一个外部包时，Go Modules会自动检测到。你运行
```
go build
```
登录后复制
或
```
go run
```
登录后复制
时，Go会自动下载这些依赖并更新
```
go.mod
```
登录后复制
和
```
go.sum
```
登录后复制
。你也可以手动添加：
```
go get github.com/gin-gonic/gin # 示例：添加Gin框架作为依赖
```
登录后复制
清理依赖： 如果你的代码中不再使用某个依赖，可以运行
```
go mod tidy
```
登录后复制
来移除
```
go.mod
```
登录后复制
中不再需要的依赖项。

我还需要关心GOPATH吗？

这是一个非常好的问题，也是很多Go开发者容易产生误解的地方。答案是：是的，你仍然需要关心GOPATH！

尽管Go Modules让你的项目代码可以脱离GOPATH，但GOPATH在Go生态系统中依然扮演着重要的角色：

工具链的安装位置： 当你使用
```
go install
```
登录后复制
命令安装一些Go工具（比如
```
golang.org/x/tools/gopls
```
登录后复制
，Go语言服务器）时，这些工具的二进制文件默认会被安装到
```
$GOPATH/bin
```
登录后复制
目录下。如果你的PATH中没有包含
```
$GOPATH/bin
```
登录后复制
，那么这些工具将无法直接在终端中运行。
模块缓存和构建缓存： Go Modules下载的依赖包的源代码（实际是缓存）和Go的构建缓存，都存放在GOPATH下的特定目录中（
```
$GOPATH/pkg/mod
```
登录后复制
和
```
$GOPATH/pkg/mod/cache
```
登录后复制
）。这些缓存对于Go的快速编译和高效工作至关重要。

所以，我的建议是：即使你主要使用Go Modules进行项目开发，也务必正确设置你的GOPATH，并确保

$GOPATH/bin

登录后复制

在你的PATH环境变量中。 这样可以保证Go的工具链、缓存机制都能正常工作，避免一些奇怪的“找不到命令”或者“依赖下载失败”的问题。我个人就遇到过一些同事，以为GOPATH完全没用就删掉了，结果一些常用的Go工具就跑不起来了，最后还是得老老实实地把GOPATH设回来。它只是从你写代码的“家”，变成了Go系统内部“存放工具和材料的仓库”。

以上就是Golang macOS Homebrew安装配置详细教程的详细内容，更多请关注php中文网其它相关文章！