在 Windows 和 macOS 上配置 Golang 语言环境

一、前言

Golang（简称 Go）是由 Google 开发的一种现代化编程语言，凭借其高效的编译速度、出色的并发处理能力，以及简洁的语法设计，在云计算、微服务、网络编程等领域得到了广泛应用。尤其是在构建高性能后端服务时，Go 已成为许多开发者的首选语言。

在使用 Go 语言之前，正确配置开发环境至关重要。无论是学习 Go 的基础知识，还是构建复杂的应用程序，都需要一个稳定、便捷的开发环境来支持代码编写、调试和运行。Windows 和 macOS 是目前开发者常用的两大主流操作系统，为了满足不同用户的需求，我们将在本文中详细讲解如何在这两种平台上配置 Go 语言环境。

通过本文，你将学会：

在 Windows 和 macOS 上下载、安装并配置 Go 环境；
配置环境变量以优化开发体验；
通过简单的示例验证环境是否正确搭建；

无论你是 Go 的初学者还是希望优化现有开发环境的开发者，这篇文章都将为你提供详尽的指导，帮助你快速搭建高效的 Go 开发环境。

注意

如果你拥有可使用的 GoLand 版本，那么你可以省去本文中 下载和安装 部分，专注于配置环境变量即可，因为 GoLand 会完全自动化地处理下载与安装部分，但是对于部分提供了可执行文件的软件包（如 kitex）来说，他们仍然需要你手动配置的环境变量。

二、在 Windows 上配置 Golang 环境

1. 下载与安装 Go

访问 Go 官方下载页面

打开浏览器，访问 Go 官方下载页面，选择适合 Windows 的安装包（通常是 .msi 格式）。

运行安装程序

• 下载完成后，双击 .msi 文件启动安装程序。

• 在安装向导中，选择安装路径（默认为 C:\Program Files\Go），并完成安装。

安装完成后的文件结构

bin: 包含 Go 的可执行文件，如 go.exe 和gofmt.exe。
src: 用于存放标准库的源代码。
pkg: 包含预编译的库文件。

2. 设置环境变量

安装完成后，需要配置环境变量以确保 Go 的工具可以在终端中正常运行。

打开环境变量设置窗口

• 右键"此电脑"或"我的电脑"，选择"属性"。

• 点击"高级系统设置" -> "环境变量"。

添加GOROOT 和PATH

GOROOT : 指向 Go 的安装目录，默认为 C:\Program Files\Go。

在"系统变量"中点击"新建"。
变量名为 GOROOT，变量值为 Go 的安装路径。

PATH : 将 Go 的 bin 目录加入 PATH。

找到 Path 变量并点击"编辑"。
添加 C:\Program Files\Go\bin 到新的行中（请替换为你 Go 安装目录下 bin 文件夹的位置）。

3. 验证安装

检查 Go 的版本

打开终端（如命令提示符或 PowerShell），输入以下命令：

bash 复制代码

go version

如果安装成功，会输出类似以下信息：

bash 复制代码

go version go1.xx.x windows/amd64

运行一个简单的 Go 程序

创建一个名为 hello.go 的文件，内容如下：

golang 复制代码

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

bash 复制代码

go run hello.go

如果输出 Hello, World!，说明配置成功。

三、在 macOS 上配置 Golang 环境

在 macOS 系统上，Go 语言环境的配置可以通过下载官方安装包或使用 Homebrew 工具实现。

1. 通过官方安装包安装 Go

下载安装包

打开 Go 官方下载页面，选择适合 macOS 的安装包（后缀为 .pkg）。
下载完成后，双击 .pkg 文件启动安装程序。

安装 Go

按照安装向导完成操作，默认安装路径为 /usr/local/go。
安装完成后，Go 的相关文件将包含以下目录：
/usr/local/go/bin: Go 的可执行文件，如 go 和 gofmt。
/usr/local/go/src: 标准库的源代码。
/usr/local/go/pkg: 预编译的库文件。

验证安装路径

打开终端，执行以下命令：

bash 复制代码

ls /usr/local/go

如果显示 Go 的相关目录和文件，说明安装成功。

2. 使用 Homebrew 安装 Go（可选）

Homebrew 是 macOS 上的一款包管理工具，可以简化 Go 的安装。

安装 Homebrew（如果未安装）

打开终端，执行以下命令安装 Homebrew：

bash 复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证 Homebrew 是否安装成功：

bash 复制代码

brew --version

安装 Go

使用 Homebrew 安装 Go：

bash 复制代码

brew install go

安装完成后，Homebrew 会将 Go 默认安装在 /opt/homebrew/Cellar/go 下。

验证安装路径

执行以下命令查看 Go 的安装路径：

bash 复制代码

brew info go

3. 设置环境变量

无论是通过安装包还是 Homebrew 安装，都需要配置环境变量以便终端可以正确识别 Go 的命令。

修改配置文件

根据使用的 Shell 类型，打开对应的配置文件：

zsh（macOS 默认 Shell）：~/.zshrc
bash：~/.bash_profile

添加环境变量

编辑配置文件，添加以下内容：

bash 复制代码

export GOROOT=/usr/local/go            # Go 的安装目录
export GOPATH=$HOME/go                 # 工作空间路径
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

如果使用 Homebrew 安装，将 GOROOT 设置为 Homebrew 的安装路径，例如：

bash 复制代码

export GOROOT=/opt/homebrew/Cellar/go/版本号

使配置生效

执行以下命令让环境变量生效：

bash 复制代码

source ~/.zshrc

4. 验证安装

检查 Go 的版本

打开终端，执行以下命令：

bash 复制代码

go version

如果安装成功，会输出类似以下信息：

bash 复制代码

go version go1.xx.x darwin/amd64

运行简单的 Go 程序

在主目录下创建一个名为 hello.go 的文件，内容如下：

golang 复制代码

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

bash 复制代码

go run hello.go

如果终端输出 Hello, World!，说明环境配置成功。