Go 开发环境安装与配置

工欲善其事，必先利其器。本章带你从零搭建 Go 开发环境：下载安装、配置代理、初始化第一个项目，并跑通 Hello World。整个过程不超过 10 分钟。

1. 下载 Go 安装包

Go 官方下载地址是 https://go.dev/dl/（旧地址 golang.org/dl/ 会跳转过来）。打开后选对应你系统的安装包：

• Windows：下载 .msi 安装包（如 go1.22.0.windows-amd64.msi），双击一路 Next 即可，安装器会自动配置 PATH。
• macOS：下载 .pkg 安装包，双击安装；也可以用 Homebrew：brew install go。
• Linux：下载 .tar.gz，解压到 /usr/local，再手动把 /usr/local/go/bin 加进 PATH。

2. 验证安装

安装完成后，打开终端（Windows 用 PowerShell 或 cmd），输入下面命令确认能识别 go 命令：

# 查看 Go 版本(确认安装成功)
go version
# 输出示例: go version go1.22.0 darwin/amd64

# 查看所有环境配置
go env

# 查看关键路径
go env GOROOT GOPATH
# 输出示例:
# /usr/local/go
# /Users/你的用户名/go

如果提示 "command not found"，说明 PATH 没配好，需要手动把 Go 的 bin 目录加入系统 PATH。

3. 三个关键环境变量

Go 的环境行为可以用 go env 命令查看和修改。下面三个最常用：

• GOROOT：Go 的安装目录（如 /usr/local/go）。一般不需要手动改，安装器会自动设置。它指向标准库源码、编译器、工具链所在的位置。
• GOPATH：Go 的工作区目录（默认是 ~/go）。在 Go 1.11 之前，所有项目都必须放在 GOPATH/src 下面才能编译；1.11 引入 go mod 后，项目可以放在任意位置，GOPATH 主要用来存放 go install 装下来的二进制和下载的依赖缓存（~/go/pkg/mod）。
• GOPROXY：模块下载代理。国内用户必设，否则下载第三方包会超时。推荐用七牛云的 goproxy.cn。

设置代理（一次性配置，写入 ~/go/env 文件，永久生效）：

# 国内用户强烈建议设置代理(加速模块下载)
go env -w GOPROXY=https://goproxy.cn,direct

# 同时设置校验数据库的代理
go env -w GOSUMDB=sum.golang.google.cn

4. go mod 模块系统

从 Go 1.16 起，所有项目都必须用 go mod。一个模块（module）就是一个独立的项目，根目录有一个 go.mod 文件记录模块名、Go 版本和依赖列表。创建一个新项目只需两步：

# 1. 新建项目目录并进入
mkdir hello && cd hello

# 2. 初始化模块(模块名一般是 github.com/用户名/项目名)
go mod init example.com/hello
# 此时目录下会生成一个 go.mod 文件,内容类似:
#   module example.com/hello
#   go 1.22

当你 import 了第三方包（比如 github.com/gin-gonic/gin）再执行 go build 或 go mod tidy，Go 会自动下载依赖并写入 go.mod 和 go.sum（依赖的校验文件）。这跟 Node 的 package.json + package-lock.json 是一个思路。

5. 写第一个程序 Hello World

在 hello 目录下新建 main.go，输入：

package main

import "fmt"

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

然后三种运行方式任选其一：

# 方式一:直接运行(不生成二进制,适合开发调试)
go run main.go
# 输出: Hello, Go!

# 方式二:编译成可执行文件(适合部署)
go build -o hello main.go
ls -lh hello
# -rwxr-xr-x  1 bigc  staff   2.1M  hello
./hello
# 输出: Hello, Go!

# 方式三:安装到 $GOPATH/bin(之后任意目录敲 hello 都能执行)
go install
which hello
# /Users/你的用户名/go/bin/hello

三者的区别要记住：

• go run：编译到临时目录并立即执行，不留下二进制，适合开发时频繁调试。
• go build：编译并在当前目录生成可执行文件，适合本地测试或部署。
• go install：编译并装到 $GOPATH/bin，之后任意位置敲命令名都能跑，适合做 CLI 工具的分发。

注意 Go 编译出的二进制体积偏大（2MB 起步），因为它把整个运行时和依赖全静态打包进去了——这是"单文件部署"的代价，也是它的优势。

6. 选择编辑器

Go 的工具链非常成熟，几乎主流编辑器都有良好支持：

• VS Code + Go 扩展（推荐新手）：免费、轻量、Microsoft 官方维护。装上 Go 扩展会自动帮你集成语法补全、跳转定义、gofmt 格式化、debug 调试。
• GoLand：JetBrains 出品的付费 IDE，开箱即用、功能最强。社区有免费的教育版。
• Vim / Neovim：装 vim-go 插件或用 LSP（gopls），老派码农最爱。

无论用哪个，都建议开启 gofmt（保存时自动格式化）和 gopls（语言服务器），它们能让你的代码风格和官方一致。

小结

到这里你应该已经能在本地跑起来 Go 程序了。记住：装好 Go → 配好 GOPROXY → 用 go mod init 建项目 → go run 跑代码。环境就绪，下一篇我们正式学 Go 的基础语法。

← 上一篇 Go 语言简介

下一篇 Go 基础语法 →