Go Modules 是 Go 1.11+ 官方推荐的依赖管理机制，通过 go mod init 初始化模块、go mod tidy 管理依赖、go get 升级版本、replace 处理冲突，实现可复现构建与版本可控。
在 Go 1.11+ 中，Go Modules 是官方推荐的依赖管理机制，取代了旧的 GOPATH 工作模式。它让项目可复现、模块可版本化、依赖关系清晰可控。初始化和升级模块是日常开发中最基础也最关键的两个操作。
初始化 Go Module
在项目根目录下运行命令即可初始化模块，生成 go.mod 文件：
-
基本命令：
go mod init，其中github.com/username/project），用于唯一标识该模块 - 如果省略模块名，Go 会尝试从当前路径推断（例如在
/home/user/myapp下执行，可能生成myapp），但不推荐——易导致导入路径错误或后续发布问题 - 初始化后不会自动下载依赖，只有在首次
go build、go run或显式执行go mod tidy时，才会拉取所需版本并写入go.mod和go.sum
添加和更新依赖
Go Modules 不需要手动编辑 go.mod，所有依赖变更都通过命令驱动：
-
自动添加新依赖：直接在代码中 import 并使用某个包（如
"golang.org/x/sync/errgroup"），然后运行go mod tidy，Go 会自动下载最新兼容版本并写入go.mod -
升级到指定版本：
go get package@v1.12.0（例如go get github.com/gin-gonic/gin@v1.9.1），会更新go.mod并同步下载 -
升级到最新补丁/小版本：
go get -u（仅升级次要版本内更新）；go get -u=patch（只升补丁版）；go get -u默认行为会升到最新兼容主版本
查看与清理依赖
了解当前依赖状态有助于排查冲突或冗余：
立即学习“go语言免费学习笔记（深入）”；
-
查看依赖图：
go list -m all列出所有直接和间接依赖及其版本；go list -u -m all还会标出可升级的版本 -
检查不一致：
go mod verify验证本地缓存模块是否与go.sum记录一致 -
清理未使用依赖：
go mod tidy会删掉go.mod中未被引用的模块，并补全缺失的 require 项，是每次提交前推荐执行的操作
处理版本冲突与 replace
当多个依赖引入同一模块的不同版本，或需临时使用本地修改/未发布版本时，可用 replace：
- 在
go.mod中添加：replace github.com/some/pkg => ./local-fork（指向本地路径）或replace github.com/some/pkg => github.com/you/fork v1.2.3 -
replace仅作用于当前模块，不影响下游消费者；若要持久化，需配合go mod edit命令，例如：go mod edit -replace github.com/old=github.com/new@v2.0.0 - 慎用
replace上线环境，它会绕过版本校验，建议仅用于调试或过渡期
