如何在macOS中搭建Golang开发环境_macOS Golang环境配置教程

在 macOS 上用 Homebrew 安装 Go 并配置 GOPATH、GOBIN 环境变量,再通过 go version、go env 和 go run hello.go 验证,最后搭配 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 + 验证三步走,环境就立住了。