Mac系统搭建Go语言开发环境完整教程

准备条件

在开始之前，请确保您的 Mac 系统已连接互联网，并且您拥有管理员权限以执行终端命令和软件安装。本指南适用于 macOS 10.12 (Sierra) 及以上版本。

安装 Go SDK

第1步：下载并安装包

访问 Go 语言中文网（golangtc.com）或官方镜像站点下载最新的 Mac 版安装包（通常为 .pkg 格式）。双击下载的 pkg 文件，按照屏幕提示一路“继续”即可完成安装。默认安装路径为 /usr/local/go。

第2步：验证安装是否成功

打开终端（Terminal），输入以下命令以检查 Go 的版本信息：

go version

如果输出类似 go version go1.x.x darwin/amd64 的信息，说明 SDK 已正确安装。若提示命令找不到，可能是 PATH 环境变量未自动生效，请尝试重启终端或重新登录系统。

配置环境变量

第3步：设置 GOPATH 工作目录

Go 语言的模块管理和第三方包都依赖于 GOPATH 环境变量。建议自定义一个专门的项目根目录（例如 /Users/[用户名]/dev/code/go），方便管理日常开发的源码。

在终端中依次执行以下操作：

1. 进入用户主目录：cd ~
2. 查看是否存在配置文件：ls -a（寻找 .bash_profile 或 .zshrc，Mac Catalina 之后默认使用 Z Shell）。
3. 使用文本编辑器打开该文件：vim .zshrc（如果是 Bash 用户使用 vim .bash_profile）。
4. 在文件中添加以下配置项：

# 设置 Go 项目根目录
export GOPATH=/Users/YOUR_USERNAME/dev/code/go
# 将 GOPATH 下的 bin 目录加入系统 PATH，以便直接调用已安装的 Go 工具
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOBIN

注意：请将 YOUR_USERNAME 替换为您实际的 Mac 用户名。

第4步：激活配置

保存文件后，返回终端执行以下命令使配置立即生效：

source ~/.zshrc

再次输入 go env，检查输出中 GOPATH 和 GOROOT 的值是否符合预期，即可确认配置无误。

初始化 Hello World 测试

第5步：创建项目与源代码

在您设定的 GOPATH 目录下创建一个名为 src/hello 的文件夹，并在其中新建 main.go 文件。内容如下：

package main

import "fmt"

func main() {
	fmt.Println("hello, go")
}

第6步：编译与运行

有两种方式可以在终端中运行此代码：

• 直接运行（不生成可执行文件）：
  $ go run main.go
  输出：hello, go
• 先编译后运行：
  编译命令：$ go build
  此时会生成一个与文件夹同名的可执行文件。
  运行命令：$ ./hello
  输出：hello, go

第7步：使用 IDE 进行开发

对于更复杂的开发，推荐使用支持 Go 语法高亮和补全的编辑器（如 VS Code 或 Sublime Text 并安装 Goplus/Gosublime 插件）。在 IDE 中打开刚才创建的 src/hello 文件夹，按 Cmd+R（或对应快捷键）可直接运行代码。

常见问题排错

如果在执行 go 命令时遇到 command not found，请检查：
- 环境变量是否被正确 export 且 source 了？
- 是否安装了多个版本的 Go 导致冲突？可使用 which go 查看当前使用的是哪个路径的 go 程序。

以上就是在Mac中搭建Go语言开发环境的详细内容，更多关于Mac开发工具配置的资料请关注本站其它相关文章！