Go Modules 是 Go 官方推荐的依赖管理机制，自1.11引入、1.16默认启用，通过go.mod文件标识模块，支持按需拉取、版本控制、校验（go.sum）及私有仓库配置。
Go Modules 是 Go 官方推荐的依赖管理机制，自 Go 1.11 起引入，1.16 起默认启用。只要项目根目录下存在 go.mod 文件，就处于 module 模式——无需 GOPATH，也不再受其限制。
如何初始化一个 Go Module
在项目根目录执行：go mod init ，其中 github.com/username/project）。Go 会自动扫描当前目录下的 .go 文件，推导出依赖并生成初始 go.mod 和 go.sum。
- 如果省略
- 若项目已存在
vendor/目录，go mod init不会自动迁移依赖；需后续用go mod tidy整理 -
go.mod中的module行必须是合法的导入路径，不能是本地相对路径或./
如何添加、升级和删除依赖
Go Modules 默认按需拉取——当你在代码中首次 import 一个包，且该包未出现在 go.mod 中时，运行 go build 或 go run 会自动下载最新 tagged 版本（或 latest commit），并写入 go.mod。
- 显式添加指定版本：
go get github.com/sirupsen/logrus@v1.9.3 - 升级到最新 patch/minor：
go get -u（仅 minor 及以下）；go get -u=patch（仅 patch） - 降级或切换分支：
go get github.com/sirupsen/logrus@master或@7a4f52b - 删除未被引用的依赖：
go mod tidy（它会删掉go.mod中冗余项，并补全缺失项）
如何理解 go.sum 文件与校验机制
go.sum 记录每个依赖模块的加密哈希值（基于内容），用于验证下载包是否被篡改。每次 go get 或 go build 都会核对；若校验失败，构建中断并报错 checksum mismatch。
立即学习“go语言免费学习笔记（深入）”；
- 不要手动编辑
go.sum；若误删或损坏，运行go mod download -dirty或go mod verify可重建 - 私有模块若使用
replace重定向到本地路径，go.sum仍会记录原始模块的哈希——此时本地修改不会触发校验失败，但上线前务必确认最终依赖一致性 - CI 环境中建议加
go mod verify步骤，防止go.sum被绕过
常见错误：require github.com/xxx: reading http/https response body: context deadline exceeded
这是典型的代理或网络问题，不是模块本身缺陷。国内用户常因无法直连 proxy.golang.org 或 sum.golang.org 导致超时。
- 临时解决：设置 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct - 跳过校验（仅开发调试）：
go env -w GOSUMDB=off（生产环境禁用） - 私有仓库需配置
GOPRIVATE：go env -w GOPRIVATE=git.example.com/*，否则会被代理强制转发 - 注意：Go 1.21+ 对
direct后缀更严格，若设为GOPROXY=direct且无可用镜像，会直接失败而非回退
模块版本语义（v0.x、v1.x、v2+/major subdirectory）和 replace/exclude 的使用边界容易混淆，实际项目中建议优先用 go mod edit 手动调整，而不是直接改 go.mod——后者极易破坏格式或引入非法语法。
