安装Golang在macOS上可通过官方安装包或Homebrew完成，推荐初学者使用官方.pkg包，开发者使用Homebrew；安装后若“go version”命令未找到，主因是PATH环境变量未正确配置，需将/usr/local/go/bin和$(go env GOPATH)/bin加入~/.zshrc或~/.bash_profile并执行source命令生效；GOPATH现主要用于存放go install工具和模块缓存，不再强制作为项目目录，GOROOT通常无需手动设置；管理多版本Go可使用goenv，通过Homebrew安装后，利用goenv install、global、local命令实现全局或项目级版本切换，确保不同项目兼容性。
在macOS上安装Golang，核心流程其实并不复杂，无非就是下载安装包或者通过包管理器来搞定，然后就是配置好环境路径。听起来简单，但往往在最后一步——环境变量的配置上，不少初学者会遇到些小麻烦，导致“go”命令找不到，或者项目构建不顺畅。别急，这事儿咱们一步步来理清楚。
在macOS上安装Golang，通常有两种主流且便捷的方式：使用官方安装包或者通过Homebrew。我个人更倾向于Homebrew，因为它能更好地管理软件版本和依赖，但对于初学者来说，官方安装包无疑是最直接的。
方法一：使用官方安装包（推荐给初学者）
https://golang.org/dl/。找到适用于macOS的最新稳定版本.pkg安装包并下载。.pkg文件，按照提示一步步进行安装。这个过程非常直观，就像安装任何其他macOS应用一样。安装程序会自动将Go安装到/usr/local/go目录，并配置好大部分必要的环境变量。go version。如果显示出Go的版本信息，比如 go version go1.x.x darwin/amd64，那么恭喜你，安装成功了。方法二：使用Homebrew（推荐给开发者）
立即学习“go语言免费学习笔记（深入）”；
如果你是macOS的开发者，Homebrew几乎是必备工具。它能让你通过命令行轻松安装和管理各种软件。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照提示完成安装。
brew install go
Homebrew会自动下载并安装最新版本的Go。
go version 来确认。Homebrew通常会帮你处理好环境变量，但偶尔也需要手动检查一下。环境变量配置（如果遇到问题或想自定义）
Go安装完成后，核心就是确保你的系统知道go命令在哪儿。这主要通过PATH环境变量来实现。
检查你的Shell配置文件： macOS Catalina及更高版本默认使用Zsh，其配置文件是~/.zshrc。如果你还在用Bash，那就是~/.bash_profile或~/.profile。
添加或检查PATH：
通常，官方安装包或Homebrew会自动将/usr/local/go/bin（官方安装）或Homebrew安装路径下的Go二进制目录添加到PATH中。
你可以通过 echo $PATH 来查看当前的路径。
如果 go version 仍然无效，你可能需要手动添加一行到你的shell配置文件中，例如（以Zsh为例）：
# 打开配置文件 nano ~/.zshrc # 或者用vim # vim ~/.zshrc # 在文件末尾添加以下行（如果Homebrew安装，通常不需要手动添加GOROOT） # export GOROOT=/usr/local/go export PATH=$PATH:/usr/local/go/bin # 针对Go Modules时代的bin目录，确保go install的工具也能找到 export PATH=$PATH:$(go env GOPATH)/bin # 保存并退出（nano: Ctrl+X, Y, Enter; vim: Esc, :wq, Enter）
激活配置： 修改配置文件后，需要让你的终端重新加载它：
source ~/.zshrc # 如果是Zsh # source ~/.bash_profile # 如果是Bash
然后再次尝试 go version。
Go Modules代理配置（可选，但推荐）
为了加速Go模块的下载，特别是当你身处网络环境可能不太友好的地方时，配置Go代理是一个好习惯。
在你的shell配置文件中添加：
export GO111MODULE=on # 确保模块模式开启（Go 1.16+ 默认开启） export GOPROXY=https://goproxy.cn,direct # 使用国内代理，或者你偏好的其他代理
然后 source 你的配置文件。
这大概是新手安装Go时最常遇到的“拦路虎”了。明明安装包跑完了，或者Homebrew显示安装成功，一敲go version，终端却冷冰冰地回复“command not found: go”。这种挫败感，我太懂了。
问题根源：PATH环境变量未生效
核心问题在于，你的操作系统不知道go这个命令的可执行文件到底藏在哪里。当你在终端输入一个命令时，系统会去PATH环境变量里列出的那些目录中挨个寻找对应的可执行文件。如果找不到，自然就报错了。
常见陷阱与排查方法：
忘记重新加载Shell配置文件： 这是最最常见的错误。你可能辛辛苦苦地把export PATH=...这行加进了~/.zshrc或~/.bash_profile，但终端并不会立刻知道这些改动。你必须手动告诉它：“嘿，我改了配置，你给我重新读一遍！”这就是source命令的作用。
source ~/.zshrc (或 .bash_profile)。或者，最简单粗暴但也有效的方法是，直接关闭当前终端窗口，再重新打开一个新的。编辑了错误的配置文件： macOS默认的Shell从Catalina开始是Zsh，配置文件是~/.zshrc。如果你不清楚，可能误编辑了~/.bash_profile，而你的系统根本不会去加载那个文件。
echo $SHELL），然后编辑对应的配置文件。PATH路径写错了或不完整： 有时候路径可能多打了一个字符，或者少了一个斜杠。另外，如果你的Go是通过官方安装包安装的，其二进制文件在/usr/local/go/bin；如果是Homebrew安装，路径可能略有不同（Homebrew会把软链接放到/usr/local/bin，通常Homebrew会帮你搞定）。
export PATH=$PATH:/usr/local/go/bin。go install安装的工具会放在$(go env GOPATH)/bin下，所以确保这行也在：export PATH=$PATH:$(go env GOPATH)/bin。GOROOT配置问题（较少见，但值得了解）： 以前GOROOT是必须配置的，它指向Go的安装根目录。现在Go版本较高时，通常不需要手动设置GOROOT，系统会自动推断。但如果你的安装比较特殊，或者系统版本较老，也可能需要手动设置。
GOROOT指向Go SDK的根目录，例如 export GOROOT=/usr/local/go。权限问题： 极少数情况下，Go的安装目录可能权限不对，导致用户无法执行其中的命令。
chmod修改。遇到“command not found”时，别慌，一步步排查，从source命令开始，再到配置文件路径，最后检查具体路径是否正确，通常都能解决问题。
谈到Go的环境变量，GOPATH和GOROOT是两个绕不开的老伙计。它们在Go的早期版本中扮演着至关重要的角色，但随着Go Modules的引入，它们的地位和作用发生了显著变化。理解这种演变，对于我们更好地管理Go项目至关重要。
GOROOT：Go的“家”
GOROOT变量指向的是Go语言的安装根目录，也就是Go SDK的所在地。你可以把它想象成Go语言在你的系统里的“老家”。所有的标准库、编译器、以及Go工具链都在这个目录里。
GOROOT了。无论是通过官方安装包还是Homebrew安装，Go工具链都能智能地找到它的GOROOT。除非你需要在同一台机器上管理多个Go SDK版本（比如通过goenv等工具），否则你几乎不需要直接与GOROOT打交道。它更多的是一个幕后英雄。GOPATH：Go项目的“工作区”——从核心到边缘
GOPATH在Go 1.11版本之前，是Go项目开发的核心概念。它定义了一个工作区，所有Go项目的源代码、编译后的二进制文件以及下载的第三方包都必须存放在GOPATH目录结构下。典型的结构是：
$GOPATH/ src/ # 存放项目源代码 pkg/ # 存放编译后的包文件 bin/ # 存放通过go install安装的可执行文件
早期作用： 强制统一项目结构，方便包的查找和引用。go get命令会将包下载到$GOPATH/src。
Go Modules时代的变革： 随着Go 1.11引入Go Modules（模块化）机制，GOPATH作为项目源代码工作区的地位被彻底颠覆。
GOPATH/src。go.mod文件管理项目依赖，依赖包不再下载到$GOPATH/src，而是被缓存到$GOPATH/pkg/mod（这是GOPATH目前最主要的作用之一）。GO111MODULE=on： 当这个环境变量设置为on时，Go工具链会优先使用模块模式。现在Go 1.16及更高版本，GO111MODULE默认就是on了。GOPATH现在还重要吗？
go install命令安装一些全局性的Go工具（比如gopls、delve等）时，这些工具的二进制文件会默认安装到$(go env GOPATH)/bin目录下。因此，确保$(go env GOPATH)/bin在你的PATH环境变量中，仍然是最佳实践。GOPATH/pkg/mod是Go Modules下载和缓存依赖的地方，这是Go工具链内部使用的，你通常不需要直接操作它。简而言之，GOPATH已经从“你的所有Go项目都必须住在这里”变成了“Go工具和模块缓存的默认存放地”。理解这种转变，能让你在现代Go开发中更加游刃有余。
在实际的开发工作中，我们往往不会只参与一个项目。不同的Go项目可能依赖于不同版本的Go语言，比如一个老项目可能还在用Go 1.15，而新项目已经切换到Go 1.20了。这时候，如何在macOS上优雅地切换和管理这些Go版本就成了一个实际问题。直接覆盖安装显然不是个好主意。幸运的是，我们有专门的版本管理工具，其中goenv就是个非常不错的选择。
为什么需要Go版本管理工具？
goenv：Go语言的版本管理器
goenv是一个轻量级的命令行工具，它的工作方式与nvm（Node.js版本管理器）或pyenv（Python版本管理器）非常相似。它通过修改PATH环境变量，让你能够在不同的Go版本之间无缝切换。
安装goenv：
最推荐的方式是使用Homebrew安装：
brew install goenv
安装完成后，你还需要将goenv的初始化脚本添加到你的Shell配置文件中（~/.zshrc或~/.bash_profile）。这通常是在安装完成后Homebrew会给出的提示：
# 在你的 ~/.zshrc 或 ~/.bash_profile 中添加以下行 export PATH="$HOME/.goenv/bin:$PATH" eval "$(goenv init -)"
添加后，别忘了 source ~/.zshrc（或 .bash_profile）来激活配置。
goenv的基本使用：
查看可安装的Go版本：
goenv install --list
这会列出所有goenv支持安装的Go版本。
安装特定Go版本：
goenv install 1.18.10 # 安装 Go 1.18.10 goenv install 1.20.7 # 安装 Go 1.20.7
goenv会从官方下载并编译安装Go。
查看已安装的Go版本：
goenv versions
你会看到所有你通过goenv安装的Go版本，以及当前正在使用的版本（前面带星号）。
设置全局Go版本：
goenv global 1.20.7
这会将Go 1.20.7设置为你的默认全局Go版本。无论你在哪个目录，都会使用这个版本。
设置局部Go版本（针对特定项目）：
cd my-go-project goenv local 1.18.10
这会在当前目录创建一个.go-version文件，告诉goenv在这个项目目录以及其子目录中使用Go 1.18.10。当你离开这个目录时，Go版本会自动切换回全局设置或父目录的局部设置。
更新goenv及其插件：
brew upgrade goenv
goenv的工作原理：
goenv通过在你的PATH环境变量中插入一个指向其自身shims目录的路径来实现版本管理。当你运行go命令时，系统会首先找到goenv的shim，然后goenv会根据你当前目录的.go-version文件或全局设置，决定调用哪个具体Go版本的二进制文件。这个过程对用户来说是透明的，非常方便。
有了goenv，在macOS上管理多个Go版本就不再是件头疼的事了。你可以根据项目需求，轻松地在不同版本之间切换，保持开发环境的整洁和高效。
以上就是Golang如何在MacOS安装Golang_GoMac系统环境搭建详细流程的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
247
收藏
取消收藏
