02 · 安装、工具链与第一个模块

目标：本机装好 Go，用官方「How to Write Go Code」路径跑通第一个 module。
官方主文：How to Write Go Code · Download

1. 安装（只走官方）

1. 打开 https://go.dev/dl/ ，按系统下载安装包（Windows 用 MSI 即可）。
2. 新开终端验证：

go version
go env GOROOT GOPATH GOMODCACHE

项	含义
GOROOT	工具链安装位置
GOPATH	工作区/缓存相关（modules 时代不必把代码塞进 src）
GOMODCACHE	下载的模块缓存

AI 注意：若 AI 让你 export GOPATH=... 并把项目放进 $GOPATH/src——那是旧时代；以 modules 文档 为准，项目可放任意目录。

2. 编辑器（AI 时代也要语言服务）

• 安装 gopls（官方语言服务器）：多数编辑器插件会自动装。
• VS Code / Cursor：官方推荐扩展 Go（golang.go）。
• 确认保存时能格式化（gofmt / goimports）。

没有 gopls，AI 补全更容易发明不存在的 API。

3. 第一个 module（照官方做一遍）

在任意学习目录：

mkdir hello
cd hello
go mod init example.com/hello

go.mod 类似：

module example.com/hello

go 1.22

创建 hello.go：

package main

import "fmt"

func main() {
	fmt.Println("hello, modules")
}

运行：

go run .
# 或
go build -o hello.exe .
./hello.exe

官方完整叙事见：https://go.dev/doc/code （含多包、测试、远程模块）。

4. 你每天会用的 go 命令

命令	用途
go run .	编译并运行当前包
go build	只编译
go test ./...	跑测试
go vet ./...	静态检查常见错误
go fmt ./...	格式化（提交前必做）
go mod tidy	整理依赖与 go.sum
go doc fmt.Println	终端看文档

习惯：改完代码先 gofmt + go test，再问 AI「为什么」。

5. 代理（国内可选）

若 go get 很慢，可配置模块代理（以你网络环境为准）。官方说明见 modules 文档中的 proxy 相关章节。配置后用 go env GOPROXY 确认。

不要用来路不明的「一键改 hosts」教程；优先官方/常用公共 proxy。

6. AI 协作提示词（本步专用）

我按 https://go.dev/doc/code 建了 module example.com/hello。
请只审查：目录是否符合 modules 习惯、有无多余依赖、go.mod 是否正常。
不要引入第三方库。给出对照官方文档的修改建议。

7. 验收清单

• [ ] go version 有输出
• [ ] go mod init + go run . 成功
• [ ] 编辑器能跳转到 fmt.Println 定义（gopls 正常）
• [ ] 知道 go fmt / go test / go mod tidy 各干什么

8. 下一步

→ 03 · Tour of Go 通关地图

官方入口

• https://go.dev/dl/
• https://go.dev/doc/code
• https://go.dev/doc/install
• https://go.dev/doc/modules