Go 高手（15）：Go 工具链——go mod、go build、go vet、go tool

更新时间：2026-09-01。本文是 languages/go/intermediate/ 高手层第 15 篇，接 测试进阶。Go 工具链是配套强大的，从依赖管理到构建、测试、分析、格式化，都集成在 go 命令里。不用配 Makefile，不用折腾 CMake，一个 go build 就够了。

本文要回答的问题

• go mod 命令怎么管理依赖？go.sum 和 go.mod 分别做什么？
• go build 的常用参数有哪些？交叉编译怎么做？
• go vet 能检测哪些问题？什么时机运行？
• go tool 提供哪些辅助工具？（pprof、trace、objdump）

一、go mod：依赖管理

# 初始化模块
go mod init github.com/user/project

# 添加依赖（运行 go build 时自动下载）
go build ./...

# 查看依赖
go list -m all

# 更新依赖
go get -u ./...

# 整理 go.mod
go mod tidy

# 验证依赖完整性
go mod verify

go.mod 和 go.sum：

• go.mod：声明模块名、Go 版本、依赖及其版本
• go.sum：记录每个依赖版本的哈希值，校验依赖完整性

go mod tidy 是最常用的命令——它会移除不再需要的依赖，添加缺失的依赖，确保 go.mod 和 go.sum 是最新的。

二、go build：构建参数

# 构建当前目录
go build

# 输出到指定路径
go build -o ./bin/myapp .

# 优化：去掉调试信息，减小体积
go build -ldflags="-s -w" .

# 条件编译：指定平台
go build -tags=production

# 查看编译过程
go build -x

# 交叉编译
GOOS=linux GOARCH=amd64 go build -o myapp-linux .
GOOS=windows GOARCH=amd64 go build -o myapp.exe .
GOOS=darwin GOARCH=arm64 go build -o myapp-mac .

-ldflags="-s -w" 减小二进制体积：

• -s：去掉符号表和调试信息
• -w：去掉 DWARF 调试信息
• 体积可减少 30-50%

三、交叉编译

Go 交叉编译非常方便，设两个环境变量就行：

# 目标平台
GOOS=linux    # linux, darwin, windows, freebsd...
GOARCH=amd64  # amd64, arm64, 386, arm...

# 常用组合
GOOS=linux GOARCH=amd64     # Linux x86_64
GOOS=linux GOARCH=arm64     # Linux ARM64（树莓派、服务器）
GOOS=windows GOARCH=amd64   # Windows x64
GOOS=darwin GOARCH=amd64    # macOS Intel
GOOS=darwin GOARCH=arm64    # macOS Apple Silicon

# 编译时自动选择（不需要手动设置）
go build  # 当前平台

四、go vet：静态分析

```go vet ./...` 在 Go 里是"发包前必做的检查"：

go vet ./...

go vet 检测的问题包括：

• Unreachable code：不可达代码
• Lost implicit error：函数返回错误但是调用者丢弃了
• Nilness：nil 指针解引用
• Resource leak：资源泄漏
• Unused variable：未使用的变量
• Shadow assignment：变量遮蔽

// go vet 能检测到的常见问题
func foo() {
    f, _ := os.Open("file.txt")
    // 忘记 close，go vet 会警告
}

func bar() error {
    // 返回错误但调用者丢弃
    return nil
}

五、go tool：内置工具

# 编译优化调试
go tool compile -S main.go  # 输出汇编

# 查看包导出
go tool nm myapp

# pprof 性能分析
go tool pprof cpu.pprof

# trace 追踪
go tool trace trace.out

# objdump 反汇编
go tool objdump myapp

# 查看逃逸分析
go build -gcflags="-m" 2>&1

# 禁用优化和内联（调试用）
go build -gcflags="-N -l"

# 生成汇编
go build -gcflags="-S" main.go 2>&1

六、go generate：代码生成

//go:generate stringer -type=Pill
type Pill int

const (
    Aspirin     Pill = iota
    Ibuprofen
    Paracetamol
)

go generate ./...
# 生成 pill_string.go

七、常用工具链命令总结

命令	作用	频率
go build	编译	每天
go run	编译并运行	每天
go test ./...	运行测试	每天
go vet ./...	静态分析	每次提交前
go mod tidy	整理依赖	提交前
go fmt ./...	格式化代码	提交前
go generate	代码生成	需要时
go tool pprof	性能分析	优化时

八、常见坑对照

坑	现象	对策
忘记 go mod tidy	依赖版本不一致，构建失败	提交前跑 go mod tidy
交叉编译后 CGO 错误	报错：CGO 需要特定工具链	设 CGO_ENABLED=0
不加 -ldflags	二进制体积大	发布时加 -ldflags="-s -w"
不跑 go vet	潜在 bug 没发现	加 CI 检查

相关与延伸

下一篇：并发模式——worker pool、pipeline、fan-in/fan-out；Go 的编译链接过程和 C 的对比，见 C 编译链接。

一句话总结

Go 工具链：go mod 管理依赖，go mod tidy 整理依赖，go.sum 校验完整性；go build -o 指定输出，-ldflags="-s -w" 减小体积；交叉编译设 GOOS/GOARCH 就行；go vet 静态分析，提交前必跑；go tool pprof 性能分析，go tool trace 追踪；go generate 代码生成，go fmt 格式化。