首先运行brew install go安装Go，再设置GOPATH和PATH环境变量，最后验证安装并运行测试程序，即可完成macOS上Go的配置。
在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 mainimport "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/
下，并通过软链接到
/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的流程，让你能把更多精力放在代码上，而不是环境配置上。我个人觉得，那种“一键搞定”的体验，真的能省下不少心力。
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
。
通常是你的代码仓库地址，例如
github.com/yourusername/yourproject
。这会生成
go.mod
文件。
mkdir my-module-projectcd my-module-projectgo 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安装配置详细教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1403845.html
微信扫一扫 
支付宝扫一扫 
