环境搭建与安装

学习任何编程语言的第一步，都是在电脑上搭建开发环境。本章将手把手教你安装 Go 语言开发环境。

安装前的准备

确认操作系统

Go 支持主流的操作系统：

确认系统架构

Go 支持多种 CPU 架构：

小提示：现在的电脑大多是 amd64 架构。如果你使用的是 Apple M1/M2/M3 芯片的 Mac，请选择 arm64 版本。

下载 Go

官方下载地址

访问 Go 官方下载页面：

• 官方地址：https://go.dev/dl/
• 国内镜像：https://golang.google.cn/dl/（推荐国内用户使用）

选择版本

页面会显示多个版本，建议选择最新稳定版：

Go 1.22.x (最新稳定版)

选择对应平台的安装包

Windows 安装步骤

方法一：使用 MSI 安装包（推荐）

第一步：下载安装包

从官网下载 .msi 安装包，如 go1.22.x.windows-amd64.msi。

第二步：运行安装程序

双击下载的 .msi 文件，按照向导提示安装：

1. 点击 "Next" 开始安装
2. 阅读许可协议，点击 "I accept" 继续
3. 选择安装路径（默认 C:\Go，建议保持默认）
4. 点击 "Install" 开始安装
5. 等待安装完成

第三步：验证安装

打开命令提示符（按 Win + R，输入 cmd），输入：

go version

如果显示类似以下输出，说明安装成功：

go version go1.22.x windows/amd64

方法二：使用压缩包

如果你不想使用安装程序，可以使用压缩包方式：

第一步：下载并解压

下载 .zip 文件，解压到你想要的位置，如 D:\Go。

第二步：配置环境变量

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"
3. 在"系统变量"中，找到 Path，点击"编辑"
4. 添加 Go 的 bin 目录：D:\Go\bin
5. 新建系统变量 GOROOT，值为 D:\Go

第三步：验证安装

打开新的命令提示符窗口，输入：

go version

macOS 安装步骤

方法一：使用 PKG 安装包（推荐）

第一步：下载安装包

从官网下载 .pkg 文件，如 go1.22.x.darwin-amd64.pkg。

第二步：运行安装程序

双击 .pkg 文件，按照向导提示安装：

1. 点击"继续"
2. 阅读许可协议，点击"同意"
3. 选择安装位置（默认 /usr/local/go）
4. 点击"安装"，输入密码确认
5. 等待安装完成

第三步：验证安装

打开终端，输入：

go version

如果显示类似以下输出，说明安装成功：

go version go1.22.x darwin/amd64

方法二：使用 Homebrew

如果你安装了 Homebrew，可以用以下命令安装：

brew install go

安装完成后，验证：

go version

Linux 安装步骤

方法一：使用压缩包（推荐）

第一步：下载压缩包

wget https://go.dev/dl/go1.22.x.linux-amd64.tar.gz

第二步：解压到 /usr/local

sudo tar -C /usr/local -xzf go1.22.x.linux-amd64.tar.gz

第三步：配置环境变量

编辑 ~/.bashrc 或 ~/.zshrc 文件：

nano ~/.bashrc

在文件末尾添加：

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

保存并退出，然后使配置生效：

source ~/.bashrc

第四步：验证安装

go version

方法二：使用包管理器

Ubuntu/Debian：

sudo apt update
sudo apt install golang-go

CentOS/RHEL：

sudo yum install golang

Arch Linux：

sudo pacman -S go

环境变量配置

重要环境变量

配置 GOPATH

GOPATH 是你的工作空间，存放你的 Go 项目和依赖包。

Windows：

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"
3. 新建系统变量 GOPATH，值为 D:\gowork（或其他你喜欢的路径）

macOS/Linux：

编辑 ~/.bashrc 或 ~/.zshrc：

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

配置 GOPROXY（国内用户必看）

由于网络原因，国内用户需要配置代理：

go env -w GOPROXY=https://goproxy.cn,direct

或者使用阿里云镜像：

go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

查看环境变量

使用以下命令查看所有环境变量：

go env

查看特定变量：

go env GOPATH
go env GOROOT
go env GOPROXY

验证安装

检查 Go 版本

go version

输出示例：

go version go1.22.x windows/amd64

检查环境变量

go env

编写测试程序

创建一个简单的测试程序：

第一步：创建项目目录

mkdir hello
cd hello

第二步：初始化模块

go mod init hello

第三步：创建 main.go 文件

package main

import "fmt"

func main() {
    fmt.Println("Go 环境安装成功！")
}

第四步：运行程序

go run main.go

如果输出 Go 环境安装成功！，恭喜你，Go 环境已经配置完成！

常见问题

Q1：命令行输入 go version 提示"不是内部或外部命令"

原因：环境变量没有配置正确，或者没有重新打开命令行窗口。

解决方法：

1. 确认 Go 安装目录正确
2. 确认 Path 环境变量包含 Go 的 bin 目录
3. 关闭当前命令行窗口，重新打开

Q2：下载依赖包超时

原因：默认的 GOPROXY 在国内访问较慢。

解决方法：

go env -w GOPROXY=https://goproxy.cn,direct

Q3：GOPATH 和 GOROOT 有什么区别？

简单理解：GOROOT 是 Go 的"家"，GOPATH 是你的"工作间"。

Q4：安装多个 Go 版本怎么办？

可以使用工具管理多个 Go 版本：

• gvm（Go Version Manager）：适用于 macOS/Linux
• g：一个简单的 Go 版本管理工具

总结

本章我们完成了 Go 开发环境的搭建：