在开始学习 Go 语言之前,我们需要正确安装和配置 Go 语言的开发环境。本文将详细介绍如何在 Windows、macOS(特别是 M1/M2 芯片)、Linux 三大平台上安装 Go,并进行环境配置和测试。
1. MacBook(macOS,M1/M2 芯片)环境搭建
由于 M1/M2 芯片采用 ARM 架构,安装 Go 时需要注意兼容性问题。
1.1 下载安装 Go(M1/M2 适配)
方法 1:使用 Homebrew 安装(推荐)
Homebrew 是 macOS 最流行的软件包管理工具,使用它可以轻松安装和管理 Go:
brew install go
安装完成后,运行:
go version
如果显示:
go version go1.21.3 darwin/arm64
说明安装成功,darwin/arm64 表示 Go 已经适配 M1/M2 架构。
方法 2:从官网下载安装
- 访问 Go 官网:https://go.dev/dl/
- 选择 macOS 版本
• Apple Silicon(M1/M2):下载 arm64 版本
• Intel Mac:下载 amd64 版本 - 安装 Go
• 下载 .pkg 文件后双击安装 - 验证安装
go version
显示 go version go1.xx.xx darwin/arm64
,表示安装成功。
1.2 配置 Go 环境变量
检查 GOPATH
(Go 工作区)
echo $GOPATH
如果没有输出或 GOPATH 未配置,可以手动添加:
# 打开 shell 配置文件
nano ~/.zshrc # 使用 Zsh(macOS 默认)
# 或者 nano ~/.bash_profile # 旧版 macOS 可能使用 bash
# 添加以下内容:
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
export PATH=$PATH:/usr/local/go/bin
# 保存并刷新配置
source ~/.zshrc
验证配置
echo $GOPATH
go env GOPATH
输出 /Users/yourname/go 说明配置成功。
1.3 运行 Go 第一个程序
mkdir -p ~/go/src/hello
cd ~/go/src/hello
nano main.go
输入:
package main
import "fmt"
func main() {
fmt.Println("Hello, Go!")
}
运行:
go run main.go
输出:
Hello, Go!
1.4 Mac(M1/M2)额外优化
✅ 解决 M1/M2 Rosetta 兼容问题
某些依赖(如 SQLite)可能默认使用 amd64 版本,导致 go build 失败。可以显式指定 ARM64 编译:
GOARCH=arm64 go build -o myapp
✅ 配置 Go Modules(推荐)
启用 Go Modules 进行依赖管理:
go env -w GO111MODULE=on
2. Windows 环境搭建
2.1 下载安装 Go
1. 下载 Windows 版本:https://go.dev/dl/
2. 运行 .msi 安装包
3. 验证安装
打开命令提示符(cmd)或 PowerShell:
go version
显示:
go version go1.21.3 windows/amd64
说明安装成功。
2.2 配置环境变量
- 右键 此电脑 → 属性 → 高级系统设置
- 环境变量 → 系统变量,添加:
GOPATH=C:\Users\你的用户名\go
GOBIN=%GOPATH%\bin
- 编辑 PATH,添加:
C:\Go\bin
%GOPATH%\bin
- 验证
echo %GOPATH%
go env
3. Linux 环境搭建
3.1 通过包管理器安装(Ubuntu / Debian)
sudo apt update && sudo apt install -y golang
3.2 手动安装
wget https://go.dev/dl/go1.21.3.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.3.linux-amd64.tar.gz
添加环境变量:
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
3.3 验证安装
go version
4. 依赖管理(Go Modules)
Go 1.14+ 版本默认启用 Go Modules 进行包管理。
4.1 启用 Go Modules
go env -w GO111MODULE=on
4.2 初始化项目
mkdir myproject && cd myproject
go mod init myproject
会生成 go.mod 文件:
<!-- go.mod -->
module myproject
go 1.21
4.3 添加依赖
go get github.com/gin-gonic/gin
4.4 查看依赖
cat go.mod
5. VS Code + Go 开发环境
5.1 安装 VS Code
5.2 安装 Go 插件
- 打开 VS Code,搜索 Go,安装官方插件(Go Team @ Google)
- 按 Ctrl + Shift + P,输入:
Go: Install/Update Tools
选择 全部安装。
6. Docker + Go 开发环境(可选)
在 Mac(M1/M2)上,建议使用 Docker 运行 Go:
docker run --rm -it golang:1.21 bash
在容器内运行:
go version
7. 常见问题(FAQ)
❓ Mac M1/M2 执行 go get 报错
go: cannot find package
✅ 解决方案:
GOARCH=arm64 go get -u github.com/gin-gonic/gin
❓ Windows PowerShell 运行 go 报错
go: command not found
✅ 解决方案:
• 确保 C:\Go\bin 在 PATH 变量中
• 运行 go env 确认路径
8. 结论
✅ macOS(M1/M2)推荐使用 Homebrew 安装 Go
✅ Windows 需要手动添加环境变量 GOPATH
✅ Linux 推荐手动安装 Go 以获取最新版本
✅ Go Modules 是推荐的依赖管理方式
✅ VS Code + Go 插件是最佳开发环境