学习目标
- 理解 Go Modules 的设计初衷与工作机制
- 掌握 go.mod / go.sum 的核心作用
- 学会处理依赖版本选择与冲突
- 掌握 replace / retract 等工程级用法
一、为什么 Go 要引入 Modules
在 Go Modules 之前，Go 依赖管理主要依赖 GOPATH：
- 所有项目共享一个依赖目录
- 无法同时使用同一库的不同版本
- 依赖版本不可控
Go Modules 解决的问题：
- 每个项目有独立的依赖版本
- 依赖版本可复现
- 不再依赖 GOPATH 结构
工程结论：Go Modules 是现代 Go 项目的基础设施。
二、go.mod 的核心作用
go.mod 描述了：
- 当前模块的 module path
- 直接依赖的模块及其版本
- 最低语言版本（go 指令）
示例：
module github.com/example/myapp
go 1.22
require (
github.com/gin-gonic/gin v1.9.1
)工程认知：
go.mod 是“声明文件”，不是锁文件。
三、go.sum 的真正意义
go.sum 用于：
- 记录依赖模块的校验和
- 保证依赖内容不可被篡改
特点：
- 可能包含大量间接依赖
- 不需要手工维护
工程规范：
- go.sum 必须提交到版本库
- 不要手动编辑 go.sum
四、最小版本选择（MVS）机制
Go Modules 使用 最小版本选择（MVS） 算法。
核心规则：
- 对同一模块，只选择一个版本
- 选择所有需求中的“最高最低版本”
示意：
- A 需要 lib v1.2.0
- B 需要 lib v1.3.0
- 最终选择 v1.3.0
工程结论：MVS 简化了依赖冲突，但不保证“最新”。
五、直接依赖 vs 间接依赖
在 go.mod 中：
- 你
require的是直接依赖 - 依赖的依赖是间接依赖
示例：
require github.com/pkg/errors v0.9.1 // indirect工程建议：
- 不要刻意手写 indirect
- 让 go mod tidy 管理依赖
六、常用 go mod 命令
go mod init：初始化模块go mod tidy：整理依赖（强烈推荐）go mod download：下载依赖go list -m all：查看依赖树
工程习惯：
依赖变更后，第一件事就是 go mod tidy。
七、replace 的工程用法
replace 用于替换依赖来源。
常见场景：
- 本地调试依赖库
- 临时替换 fork 版本
示例：
replace github.com/example/lib => ../lib工程规范：
- replace 通常只用于开发阶段
- 提交前需确认是否保留
八、retract：撤回有问题的版本
retract 用于声明：
- 某些版本不应再被使用
示例：
retract v1.2.3 // critical bug工程价值：
- 防止下游项目误用坏版本
- 比“删 tag”更规范
九、私有仓库与 GOPRIVATE
使用私有仓库时，需要配置：
export GOPRIVATE=github.com/mycompany/*作用：
- 跳过公共代理
- 跳过校验数据库
工程结论：私有依赖必须显式声明。
十、依赖管理的工程原则
- 依赖越少，风险越低
- 避免“引入即用”的大而全库
- 定期更新依赖，但不要频繁抖动
- 依赖变更要可回滚
工程结论：依赖管理是风险管理。
十一、Go Modules 总结
- Modules 是 Go 依赖管理的核心机制
- MVS 简化了版本选择
- replace / retract 是工程级工具
一句话总结：
稳定的依赖，是稳定系统的前提。
预告：Day 27｜测试体系与测试驱动思维
下一天将系统讲解：
- Go testing 包的设计思想
- 单元测试 / 表驱动测试
- mock 与接口设计
- 如何写“值得维护”的测试