MacOS搭建Golang环境教程

本文手把手教你如何在 macOS 上高效、简洁地搭建 Go（Golang）开发环境：通过 Homebrew 一键安装 Go，合理配置 GOPATH 和 GOBIN 环境变量（兼顾现代模块模式与传统工具兼容性），并用三行命令快速验证安装是否成功；最后推荐搭配 VS Code 官方 Go 插件，开箱即用获得智能提示、调试和格式化支持——全程无需手动下载解压或复杂配置，真正实现“三步立住、零踩坑”的新手友好体验。

在 macOS 上搭建 Go 开发环境其实很直接，关键是选对安装方式、配好环境变量，并验证是否生效。下面分几步说清楚，不绕弯子。

用 Homebrew 安装 Go（推荐）

Homebrew 是 macOS 最常用的包管理器，安装 Go 最省心的方式就是它。

• 如果还没装 Homebrew，先在终端运行：
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 装好后执行：
  brew install go
• Homebrew 会自动把 Go 装到 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），并确保命令行可识别

手动配置 GOPATH 和 GOBIN（可选但建议）

从 Go 1.16 起，模块模式默认开启，GOPATH 不再强制用于项目存放，但某些工具或老项目仍依赖它。建议明确设一个干净的路径。

• 在终端中运行：
  mkdir -p ~/go/{bin,src,pkg}
• 编辑 shell 配置文件（zsh 用户改 ~/.zshrc，bash 用户改 ~/.bash_profile）：
  echo 'export GOPATH=$HOME/go' >> ~/.zshrc
  echo 'export GOBIN=$GOPATH/bin' >> ~/.zshrc
  echo 'export PATH=$PATH:$GOBIN' >> ~/.zshrc
• 重载配置：
  source ~/.zshrc

验证安装是否成功

别跳过这步，三行命令就能确认环境跑得稳不稳。

• 查看 Go 版本：
  go version（应输出类似 go version go1.22.3 darwin/arm64）
• 检查环境变量：
  go env GOPATH GOBIN GOROOT（确认路径合理，GOROOT 通常是 Homebrew 自动设好的）
• 写个小程序试试：
  echo 'package main; import "fmt"; func main() { fmt.Println("Hello, Go!") }' > hello.go
  go run hello.go（终端应输出 Hello, Go!）

顺手配个代码编辑器（VS Code 示例）

写 Go 不一定非用 VS Code，但它插件成熟，对新手最友好。

• 安装 VS Code 后，扩展里搜 “Go”，装官方 Microsoft 提供的插件
• 首次打开 .go 文件时，它会提示安装依赖工具（如 gopls、dlv、goimports），点 “Install All” 就行
• 确保设置里启用了 “Format: Format On Save”，写代码更省心

基本上就这些。不用折腾 SDK 管理器，也不用下载压缩包解压配路径——Homebrew + 明确 GOPATH + 验证三步走，环境就立住了。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。