Go Modules 是 Go 官方自1.11起支持、1.16起默认启用的依赖管理机制，取代 GOPATH 和旧工具；它通过 go.mod 和 go.sum 实现版本精确控制与校验，避免依赖错乱。
Go Modules 是什么，为什么现在必须用它
Go 1.11 起官方正式支持 go mod，1.16 开始默认启用，不再需要 $GOPATH 目录结构。如果你还在手动维护 src/pkg/bin，或者用 dep、glide 等旧工具，项目大概率会在新 Go 版本中构建失败或依赖错乱。
初始化一个新模块：从 go mod init 开始
在项目根目录下运行：
go mod init example.com/myapp
这会生成 go.mod 文件，其中包含模块路径和 Go 版本声明。注意：
- 模块路径不一定要是真实可访问的域名，但应具备唯一性和可读性（避免用 main 或 project 这类泛化名）
- 如果当前目录已有 import 语句，go mod init 会自动推导并补全依赖
- 若漏写模块路径，命令会尝试从当前路径名推断，但容易出错，建议显式指定
添加/更新依赖时，go get 的行为已彻底改变
执行 go get 不再把包下载到 $GOPATH/src，而是：
- 自动写入 go.mod（新增 require 行）
- 下载到本地 pkg/mod 缓存，并在 go.sum 中记录校验和
- 默认拉取最新 tagged 版本（如 v1.12.0），不是 master 分支
常见操作示例：
Git 历史考古工具，回答“为什么这段代码存在？”，适用于任意文件、行或可疑代码块。链式调用 git blame → git log --follow → commit 信息...
- 拉取特定版本：
go get github.com/gin-gonic/gin@v1.9.1 - 升级到最新 patch 版本：
go get -u=patch github.com/sirupsen/logrus - 临时使用某分支（不推荐长期）：
go get github.com/your/repo@fix-bug-branch - 排除某个有问题的间接依赖：
go mod edit -exclude github.com/bad/pkg@v0.3.0
go mod tidy 和 go.sum 的实际作用
go mod tidy 会：
- 删除 go.mod 中未被代码引用的 require 条目
- 补全缺失的间接依赖（即 transitive deps）
- 同步更新 go.sum，确保所有依赖哈希一致
go.sum 不是“锁文件”（不像 yarn.lock），但它强制校验每个模块的完整性。如果有人篡改了缓存中的包内容，go build 会直接报错：checksum mismatch。
立即学习“go语言免费学习笔记（深入）”；
注意事项：
- 不要手动编辑 go.sum，它由 Go 工具链自动生成和维护
- CI 环境中务必运行 go mod tidy 并提交 go.mod 和 go.sum
- 若团队混用不同 Go 版本，go.sum 可能因校验算法微调而变动，建议统一 Go 小版本（如全部用 1.21.x）
模块路径命名、replace 的滥用、私有仓库认证配置，这些是进阶痛点，但只要坚持从 go mod init 起规范起步，90% 的环境问题其实根本不会出现。
