Go Modules是Golang依赖管理的核心工具，自Go 1.16起默认启用，通过go mod init初始化模块，生成go.mod文件记录模块路径与依赖版本；执行go build或go get自动下载依赖并写入go.mod和go.sum，后者用于校验依赖完整性；使用go get可指定版本、latest或主干分支更新依赖；go mod tidy清理未使用依赖；私有模块需配置GOPRIVATE环境变量并确保凭证正确；replace指令可用于本地调试但生产环境慎用；定期维护依赖避免技术债务。
在 Golang 中管理包的版本，核心依赖的是 Go Modules。从 Go 1.11 开始引入 Modules，到 Go 1.16 成为默认构建模式，模块系统彻底改变了 Go 的依赖管理方式。它让开发者不再需要将代码放在 $GOPATH 目录下，也能精准控制依赖版本。
启用 Go Modules
要使用模块功能，首先要确保环境变量 GO111MODULE 设置为 on（Go 1.16+ 默认开启）：
- 可以通过 go env GO111MODULE 查看当前设置
- 若未开启，运行 go env -w GO111MODULE=on 启用
初始化一个新模块只需执行：
go mod init example.com/myproject
这会生成 go.mod 文件，记录模块路径和 Go 版本。
立即学习“go语言免费学习笔记（深入）”；
go.mod 与依赖版本控制
go.mod 是模块的核心配置文件，包含模块名、Go 版本以及依赖项。
当你首次导入外部包并运行构建或测试时，Go 会自动下载依赖，并写入 go.mod 和 go.sum 文件。
例如：
import "github.com/gin-gonic/gin"
执行 go build 后，Go 自动添加类似内容到 go.mod：
require github.com/gin-gonic/gin v1.9.1
你也可以手动升级或降级版本：
- go get github.com/gin-gonic/gin@v1.8.0 —— 指定版本
- go get github.com/gin-gonic/gin@latest —— 获取最新版
- go get github.com/gin-gonic/gin@master —— 使用主干分支（不推荐生产环境）
使用 go.sum 验证依赖完整性
go.sum 记录了每个依赖模块的特定版本校验和，用于保证每次下载的代码一致性，防止恶意篡改。
不要手动修改这个文件，由 Go 工具链自动维护。如果发现校验失败，可能是网络问题或依赖被篡改，需警惕。
清理无用依赖：
go mod tidy
这条命令会删除未使用的依赖，并补全缺失的依赖，保持 go.mod 干净准确。
私有模块处理
如果你的项目依赖公司内部 Git 仓库的模块，需配置 GOPRIVATE 环境变量，避免 Go 尝试通过公共代理拉取：
go env -w GOPRIVATE="git.company.com,*.internal"
同时确保 SSH 或 HTTPS 凭据正确配置，以便访问私有仓库。
还可通过 replace 指令本地调试依赖：
replace example.com/other/project => ../other/project
开发完成后记得移除 replace，避免影响 CI/CD 构建。
基本上就这些。Go Modules 设计简洁，自动化程度高，只要理解 go.mod 和 go get 的基本用法，就能高效管理项目依赖版本。关键是保持依赖更新及时，定期检查过期包，避免技术债积累。
