模块与包管理

这一课你将能做到

1. 用 go mod init 创建模块，说出 go.mod 每一行的含义
2. 把项目拆成多个包，正确运用「首字母大写导出、小写包内私有」规则和导入路径
3. 熟练使用 go get、go mod tidy、go build、go run、go vet 等日常命令

为什么要学

前面的代码都是单文件单包，玩具阶段。真实项目一定是多包目录 + 若干第三方依赖：net/http 封装在哪个包、别人的库怎么引入、版本冲突谁说了算、为什么别人的包你能 import 而有的不行——这些全部由 Go 的模块系统（go modules，Go 1.11+ 引入，1.16 起默认开启）管理。

包（package）是代码组织单位，模块（module）是依赖与版本单位。理清这两层，项目结构、依赖管理、团队协作就都有了秩序。

先建立图像

一个典型 Go 项目的目录树与它的模块文件：

calculator/                     ← 项目根目录 = 模块根
├── go.mod                      ← 模块身份证 + 依赖清单
├── go.sum                      ← 依赖内容的校验清单（哈希）
├── main.go                     ← package main，程序入口
└── pkg/
    └── ops/
        └── ops.go              ← package ops，业务子包

go.mod 内容：
module example.com/calculator   ← 模块路径：别人 import 你时的前缀

go 1.22                          ← 语言版本要求

require (
	github.com/google/uuid v1.6.0   ← 依赖 + 精确版本
)

导入路径 = 模块路径 + 子目录。比如 example.com/calculator/pkg/ops。

跟着做

步骤 1：创建模块

$ mkdir calculator && cd calculator
$ go mod init example.com/calculator
go: creating new go.mod: module example.com/calculator

模块路径通常写「域名 + 路径」（方便将来发布到 GitHub）；本地练手随便起一个不冲突的即可。打开 go.mod 确认内容。

步骤 2：拆出第一个子包

创建 pkg/ops/ops.go：

package ops // 包名惯例：小写、单个单词、与目录名一致

import "fmt"

// Add 首字母大写 → 导出（公开），任何包都能调用
func Add(a, b int) int {
	return a + b
}

// multiply 首字母小写 → 未导出（私有），只在 ops 包内可见
func multiply(a, b int) int {
	return a * b
}

// Double 是包内函数，演示私有函数的用法
func Double(a int) int {
	return multiply(a, 2)
}

func init() {
	// init 函数：包被导入时自动执行，可执行初始化
	fmt.Println("ops 包已加载")
}

步骤 3：在 main 中导入并调用

项目根目录创建 main.go：

package main

import (
	"fmt"

	"example.com/calculator/pkg/ops" // 导入路径 = 模块路径 + 子目录
)

func main() {
	fmt.Println(ops.Add(1, 2)) // 3
	fmt.Println(ops.Double(5)) // 10
	// fmt.Println(ops.multiply(2, 3)) // 编译错误：multiply 未导出
}

运行：

$ go run .
ops 包已加载
3
10