Engineering

Go 语言开发环境搭建：从零开始的冒险

手把手带你搭建 Go 语言开发环境，从安装到写出第一个 Hello World，开启你的 Go 语言之旅

Leeting Yan 2020-02-03 13 分钟阅读 6164 字

Go 语言开发环境搭建：从零开始的冒险

嗨，朋友！欢迎来到 Go 语言的世界。

如果你正在读这篇文章，说明你大概已经听说了 Go 语言的一些好处——也许是它超快的编译速度，也许是它简洁优雅的语法，又或者是它强大的并发能力。不管是什么原因把你带到这里，我都很高兴能陪你一起踏上这段旅程。

在正式开始学习 Go 语言之前，我们得先把"工具"准备好。就像木匠要有锤子和锯子，画家要有画笔和颜料，我们程序员也得先把开发环境搭好，才能开始写代码。

别担心，这个过程一点都不复杂。跟着我一步步来，大概 10-15 分钟就能搞定。

为什么要选择 Go 语言？

在我们开始动手之前，先花一分钟聊聊 Go 语言到底有什么特别的，值得我们去学习。

Go 语言（官方名称是 Go，但很多人也叫它 Golang）是由 Google 在 2009 年开源的一门编程语言。它的三位主要设计者是 Robert Griesemer、Rob Pike 和 Ken Thompson——这几位可都是计算机科学界的大神级人物，其中 Ken Thompson 还是 Unix 操作系统和 C 语言的共同创造者之一。

Go 语言的设计目标是简单、高效、可靠。它试图解决 Google 内部在开发大规模软件时遇到的一些痛点，比如：

编译速度慢：大型项目编译一次要花几十分钟甚至几个小时
依赖管理复杂：各种库的版本依赖关系像一团乱麻
并发编程困难：写出正确且高效的并发程序太容易出错
语言特性过于复杂：C++ 的特性太多，新人上手困难

Go 语言的解决方案是做减法——去掉了很多其他语言中常见的特性（比如类继承、泛型、异常等），只保留最核心、最实用的部分。这让 Go 语言变得非常简单易学，但也因此引起了一些争议。

不过，经过十多年的发展，Go 语言已经证明了自己的价值。现在，很多知名的公司和项目都在使用 Go：

Docker：容器技术的开创者，完全用 Go 编写
Kubernetes：Google 开源的容器编排系统，也是 Go 写的
Terraform：基础设施工具，Go 语言开发
etcd：分布式键值存储，CoreOS 开发
Prometheus：监控系统，SoundCloud 开源

看到这些名字，你应该能感受到 Go 语言在云原生和基础设施领域的统治力了吧？

好了，废话不多说，让我们开始动手搭建环境！

第一步：下载和安装 Go

Windows 用户

打开浏览器，访问 Go 的官方下载页面：https://golang.org/dl/
你会看到一个蓝色的按钮，写着 “Download Go”。点击它，网站会自动检测你的操作系统，并推荐适合你的安装包。如果你是 Windows 系统，应该是一个 .msi 文件。
下载完成后，双击这个 .msi 文件，按照安装向导的提示一步步操作。大部分时候你只需要点 “Next” 就可以了。
安装程序默认会把 Go 安装到 C:\Go 目录下，这个路径是可以改的，但建议你保持默认，这样后面配置环境变量会简单很多。
安装完成后，安装程序会自动帮你设置好环境变量，所以你不需要手动去改什么。

macOS 用户

macOS 用户有两种安装方式：

方式一：使用官方安装包（推荐新手）

访问 https://golang.org/dl/
下载 .pkg 格式的安装包
双击安装包，按照提示完成安装
Go 会被安装到 /usr/local/go 目录下

方式二：使用 Homebrew（适合熟悉命令行的用户）

如果你已经安装了 Homebrew（macOS 上最流行的包管理器），可以用一条命令搞定：

brew install go

这种方式更简洁，而且后续升级也很方便，只需要运行 brew upgrade go 就可以了。

Linux 用户

Linux 用户的安装方式也有很多种，这里介绍最常用的两种：

方式一：从官网下载压缩包

# 下载 Go 的压缩包（以 1.14 版本为例）
wget https://dl.google.com/go/go1.14.linux-amd64.tar.gz

# 解压到 /usr/local 目录
sudo tar -C /usr/local -xzf go1.14.linux-amd64.tar.gz

# 删除压缩包（可选）
rm go1.14.linux-amd64.tar.gz

方式二：使用包管理器

不同的 Linux 发行版有不同的包管理器：

Ubuntu/Debian：

sudo apt update
sudo apt install golang-go

CentOS/RHEL/Fedora：
```
sudo yum install golang
```
Arch Linux：
```
sudo pacman -S go
```

⚠️ 小贴士：使用包管理器安装的 Go 版本可能不是最新的。如果你想用最新版本，建议用方式一。

第二步：配置环境变量

安装完 Go 之后，我们还需要配置一些环境变量，让系统知道 Go 装在哪里，以及我们的 Go 项目放在哪里。

理解几个重要的环境变量

在 Go 1.11 之前，有几个环境变量是必须配置的：

GOROOT：Go 的安装路径。比如 Windows 上是 C:\Go，Linux/macOS 上是 /usr/local/go。
GOPATH：你的 Go 工作空间，也就是你存放 Go 项目代码的地方。
PATH：系统路径，需要包含 Go 的可执行文件目录。

不过，从 Go 1.11 开始，Go 引入了 Go Modules（模块）机制，这让依赖管理变得简单多了。使用 Go Modules，你就不再需要严格依赖 GOPATH 了，可以在任何目录下创建 Go 项目。

但是，GOPATH 仍然有其存在的意义——它用来存放你下载的第三方库和编译后的可执行文件。所以，我们还是应该配置一下。

Windows 配置方法

按 Win + R，输入 sysdm.cpl，回车打开系统属性
切换到 “高级” 选项卡，点击 “环境变量”
在 “系统变量” 或 “用户变量” 中找到 Path，双击编辑
添加两条路径：
- C:\Go\bin（Go 的可执行文件）
- %GOPATH%\bin（编译后的工具）
新建一个用户变量 GOPATH，值设为你想要的工作目录，比如 C:\Users\YourName\go

macOS 和 Linux 配置方法

打开你的 shell 配置文件（如果你用的是 bash，就是 ~/.bash_profile 或 ~/.bashrc；如果你用的是 zsh，就是 ~/.zshrc），在文件末尾添加：

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

保存文件后，运行以下命令让配置生效：

source ~/.zshrc  # 如果你用的是 zsh
# 或者
source ~/.bash_profile  # 如果你用的是 bash

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

好了，环境配置完了，现在我们来验证一下 Go 是否安装成功。

打开终端（Windows 用户打开命令提示符或 PowerShell），输入：

go version

如果一切正常，你应该会看到类似这样的输出：

go version go1.14 darwin/amd64

这表示你安装的是 Go 1.14 版本，运行在 macOS（darwin）的 64 位系统上。具体的版本号和操作系统信息可能会不一样，但只要能看到 go version 后面跟着版本号，就说明安装成功了。

🎉 恭喜！ 你已经成功安装了 Go 语言！

如果运行命令后提示 go: command not found 或者类似的错误，那说明环境变量没有配置好。回头检查一下第二步，看看 PATH 是不是设置对了。

第四步：配置你的编辑器

虽然理论上你可以用任何文本编辑器来写 Go 代码（哪怕是 Windows 的记事本），但一个好的编辑器能极大地提升你的开发效率。

这里我推荐几个比较流行的选择：

Visual Studio Code（强烈推荐）

Visual Studio Code（简称 VS Code）是微软开发的一款免费、开源的代码编辑器。它轻量、快速、插件生态丰富，是目前最受欢迎的代码编辑器之一。

安装步骤：

访问 https://code.visualstudio.com/ 下载并安装 VS Code
打开 VS Code，点击左侧的扩展图标（或者按 Ctrl+Shift+X / Cmd+Shift+X）
在搜索框中输入 “Go”，找到由 “Go Team at Google” 发布的官方扩展
点击 “Install” 安装
安装完成后，VS Code 会提示你安装一些 Go 的工具（比如 gopls、dlv 等），点击 “Install All” 全部安装

安装完 Go 扩展后，你就拥有了：

代码自动补全
跳转到定义
实时错误检查
代码格式化
调试支持
还有很多其他强大的功能

GoLand

GoLand 是 JetBrains 公司开发的一款专业的 Go 语言 IDE。JetBrains 就是开发了 IntelliJ IDEA、PyCharm、WebStorm 等知名 IDE 的那家公司，品质有保障。

GoLand 是一款商业软件，需要付费购买许可证，但它提供了 30 天的免费试用期。如果你是学生或教师，可以申请免费的教育许可证。

GoLand 的功能非常强大，开箱即用，不需要额外安装插件。如果你预算充足，或者公司愿意买单，GoLand 是一个非常棒的选择。

Vim / Neovim + 插件

对于喜欢命令行的极客们来说，Vim 或 Neovim 配合一些 Go 相关的插件，也能打造一个非常高效的开发环境。

常用的插件有：

vim-go：最流行的 Vim Go 插件
coc.nvim：提供语言服务器协议（LSP）支持

这种方式配置起来比较折腾，但一旦配置好了，写代码的效率会非常高，因为你完全不需要用鼠标，双手不离键盘。

其他选择

除了上面三个，还有很多其他的编辑器也支持 Go 开发：

Sublime Text：轻量快速，配合 GoSublime 插件
Atom：GitHub 开发的编辑器，有 go-plus 插件
Emacs：配合 go-mode 插件

选哪个都可以，关键是用得顺手。如果你没有特别的偏好，我建议你从 VS Code 开始，它免费、易用、功能强大，是大多数 Go 开发者的首选。

第五步：编写你的第一个 Go 程序

终于到了激动人心的时刻——我们要写第一个 Go 程序了！

按照程序界的传统，我们学习任何一门新语言时，第一个程序都应该是打印 “Hello, World!"。这个传统可以追溯到 1978 年的经典著作《The C Programming Language》，从那以后就一直延续下来了。

创建项目目录

首先，我们需要一个地方来存放我们的代码。在你喜欢的地方创建一个新目录：

# macOS / Linux
mkdir -p ~/projects/hello-go
cd ~/projects/hello-go

# Windows
mkdir C:\projects\hello-go
cd C:\projects\hello-go

编写代码

在你喜欢的编辑器中打开这个目录，然后创建一个新文件，命名为 main.go，输入以下代码：

package main

import "fmt"

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

就这么几行代码，看起来是不是很简单？让我来逐行解释一下：

第 1 行：package main

这行代码声明了这个文件属于 main 包。在 Go 语言中，所有的代码都组织在"包”（package）里。main 包比较特殊，它是一个可执行程序的入口。当你运行一个 Go 程序时，Go 会从 main 包的 main() 函数开始执行。

第 3 行：import "fmt"

这行代码导入了 fmt 包。fmt 是 “format” 的缩写，它是 Go 标准库中的一个包，提供了格式化输入输出的功能。我们用到的 Println 函数就在这个包里。

第 5-7 行：func main() { ... }

这定义了一个名为 main 的函数。func 是 Go 语言中定义函数的关键字。main 函数是整个程序的入口点，程序从这里开始执行。花括号 {} 里面是函数的主体，包含了程序要执行的代码。

第 6 行：fmt.Println("Hello, World!")

这是函数体，也是程序真正做事的地方。fmt.Println 是一个函数调用，它会在终端打印一段文本，然后自动换行。"Hello, World!" 是我们要打印的字符串。

运行程序

好了，代码写完了，现在让我们运行它！

在终端中，确保你当前在 hello-go 目录下，然后输入：

go run main.go

你应该会看到输出：

Hello, World!

太棒了！你的第一个 Go 程序跑起来了！🎉

go run 命令会编译并运行你的 Go 程序。它是开发阶段快速测试代码的好帮手。

编译成可执行文件

如果你想要生成一个独立的可执行文件，可以使用 go build 命令：

go build main.go

这会在当前目录下生成一个可执行文件（在 Windows 上是 main.exe，在 macOS/Linux 上是 main）。

你可以直接运行它：

# macOS / Linux
./main

# Windows
main.exe

输出结果和之前一样：

Hello, World!

💡 小贴士：go run 适合开发阶段快速测试，go build 适合生成最终的可执行文件用于部署。

第六步：了解 Go Modules

在我们继续深入之前，还有一个重要的概念需要了解——Go Modules。

什么是 Go Modules？

在 Go 1.11 之前，Go 的依赖管理一直是个痛点。所有的包都必须放在 GOPATH 下，版本号管理也很麻烦。社区出现了很多第三方工具（比如 glide、dep、govendor）来解决这个问题，但都不够完美。

Go 1.11 引入了 Go Modules，这是 Go 官方的依赖管理方案。它让你可以在任何目录下创建项目，并且能够精确地管理依赖的版本。

初始化一个模块

让我们把刚才的 hello-go 项目转换成一个 Go Module：

go mod init hello-go

这会在当前目录下创建一个 go.mod 文件，内容大概是这样的：

module hello-go

go 1.14

这个文件声明了这个项目是一个名为 hello-go 的模块，并且使用 Go 1.14 版本。

添加依赖

现在，让我们来试试添加一个第三方依赖。修改 main.go：

package main

import (
	"fmt"
	"github.com/fatih/color"
)

func main() {
	fmt.Println("Hello, World!")
	color.Cyan("This is cyan text!")
}

我们导入了一个第三方库 github.com/fatih/color，它可以让终端输出带颜色的文字。

现在运行：

go run main.go

Go 会自动下载这个依赖，然后编译运行程序。你会看到：

Hello, World!
This is cyan text!

（第二行会是青色的，如果你的终端支持颜色的话。）

查看一下当前目录，你会发现多了一个 go.sum 文件。这个文件记录了所有依赖的校验和，确保每次构建都使用相同版本的依赖。

再次打开 go.mod，你会发现它变成了：

module hello-go

go 1.14

require github.com/fatih/color v1.9.0

Go 自动帮我们添加了依赖声明。

常用命令

这里是一些常用的 Go Modules 命令：

# 初始化新模块
go mod init <module-name>

# 添加或升级依赖
go get <package-path>

# 下载所有依赖
go mod download

# 清理未使用的依赖
go mod tidy

# 查看当前模块的依赖
go list -m all

第七步：一些实用的小技巧

在你开始深入学习 Go 语言之前，我想分享几个能让你的开发体验更好的小技巧。

1. 使用 `go fmt` 自动格式化代码

Go 有一个内置的代码格式化工具 go fmt，它会自动帮你把代码格式化成 Go 社区公认的标准风格。这让你不用再为缩进、空格这些琐事烦恼。

使用方法很简单：

go fmt main.go

或者格式化整个项目：

go fmt ./...

💡 小贴士：大多数现代编辑器（比如 VS Code）会在你保存文件时自动运行 go fmt，你什么都不用做。

2. 使用 `go vet` 检查代码问题

go vet 是 Go 自带的静态分析工具，它能帮你发现一些潜在的问题，比如：

Printf 格式化字符串和参数不匹配
结构体标签格式错误
不可达的代码

使用方法：

go vet main.go

3. 使用 `godoc` 查看文档

Go 的标准库文档非常完善，你可以用 godoc 命令在本地查看：

# 查看 fmt 包的文档
godoc fmt

# 查看 fmt.Println 函数的文档
godoc fmt Println

# 启动本地文档服务器
godoc -http=:6060

最后一条命令会在本地启动一个 Web 服务器，你可以在浏览器中访问 http://localhost:6060 来查看所有包的文档，非常方便。

当然，你也可以直接访问在线文档：https://pkg.go.dev/

4. 学会使用 `go help`

如果你对某个命令不确定用法，随时可以用 go help 来查看帮助：

# 查看所有可用的命令
go help

# 查看某个具体命令的帮助
go help run
go help build
go help mod

常见问题解答

Q：我应该学哪个版本的 Go？

A：建议你学习最新稳定版。Go 的向后兼容性很好，新版本添加的特性不会破坏旧代码。截至 2020 年 2 月，最新稳定版是 Go 1.14。

Q：Go 语言难学吗？我需要有编程基础吗？

A：Go 语言的语法非常简单，如果你有 C、Java 或 Python 的基础，会学得非常快。但即使你是编程新手，Go 也是一个很好的入门语言，因为它没有太多复杂的概念。

Q：学 Go 能做什么？

A：Go 特别适合开发：

Web 服务和 API
微服务架构
命令行工具
云原生应用（Docker、Kubernetes 生态）
网络编程
并发程序

Q：我需要配置代理吗？

A：如果你在中国大陆，下载某些依赖可能会比较慢。你可以配置 Go 的模块代理：

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

这会使用 goproxy.cn 这个国内镜像，速度会快很多。

小结

恭喜你！你已经成功搭建了 Go 语言开发环境，并且写出了你的第一个 Go 程序。让我们回顾一下今天学到的内容：

✅ 下载并安装了 Go 语言
✅ 配置了环境变量（GOPATH、PATH）
✅ 验证了安装是否成功
✅ 选择并配置了代码编辑器（推荐 VS Code）
✅ 编写并运行了第一个 “Hello, World!” 程序
✅ 了解了 Go Modules 依赖管理
✅ 学习了一些实用的小技巧（go fmt、go vet、godoc）

这只是一个开始。在接下来的文章里，我们会深入学习 Go 语言的各个方面——从变量和数据类型，到控制流、函数、接口，再到强大的并发编程。

Go 语言的魅力在于它的简洁和高效。你会发现，用 Go 写代码就像写伪代码一样自然，但它的性能却能媲美 C/C++。这种"简单但不简陋"的设计哲学，正是 Go 语言最吸引人的地方。

练习时间

在结束这篇文章之前，给你留几个小练习，帮你巩固今天学到的知识：

修改 Hello World 程序：让它打印你的名字，比如 “Hello, Alice!”
尝试使用其他 fmt 函数：比如 fmt.Print（不换行）、fmt.Printf（格式化输出）
添加更多颜色：用 color 库打印出红色、绿色、黄色的文字
探索 go.mod：尝试手动修改 go.mod 文件，然后运行 go mod tidy 看看会发生什么

下一篇预告

在下一篇文章中，我们将深入探讨 Go 语言的变量和数据类型。你会学到：

如何声明变量
Go 的基本数据类型（整数、浮点数、字符串、布尔值等）
类型转换
常量和 iota
Go 的零值机制

准备好了吗？我们下篇见！👋

参考资料：

继续阅读

探索更多技术文章

浏览归档，发现更多关于系统设计、工具链和工程实践的内容。

全部文章返回首页

Go 语言开发环境搭建：从零开始的冒险

为什么要选择 Go 语言？

第一步：下载和安装 Go

Windows 用户

macOS 用户

Linux 用户

第二步：配置环境变量

理解几个重要的环境变量

Windows 配置方法

macOS 和 Linux 配置方法

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

第四步：配置你的编辑器

Visual Studio Code（强烈推荐）

GoLand

Vim / Neovim + 插件

其他选择

第五步：编写你的第一个 Go 程序

创建项目目录

编写代码

运行程序

编译成可执行文件

第六步：了解 Go Modules

什么是 Go Modules？

初始化一个模块

添加依赖

常用命令

第七步：一些实用的小技巧

1. 使用 go fmt 自动格式化代码

2. 使用 go vet 检查代码问题

3. 使用 godoc 查看文档

4. 学会使用 go help

常见问题解答

小结

练习时间

下一篇预告

探索更多技术文章

1. 使用 `go fmt` 自动格式化代码

2. 使用 `go vet` 检查代码问题

3. 使用 `godoc` 查看文档

4. 学会使用 `go help`