Go 模块（Go Modules）是 Golang 官方从 1.11 版本引入的依赖管理机制，解决了早期 GOPATH 模式下依赖版本混乱的问题。通过 go.mod 文件，开发者可以精确控制项目所依赖模块的版本，实现可复现构建和版本隔离。
启用 Go 模块并初始化项目
要使用模块功能，首先确保环境变量 GO111MODULE=on（Go 1.13+ 默认开启）。在项目根目录执行：
go mod init example.com/myprojec
t
该命令会生成一个 go.mod 文件，内容类似：
module example.com/myproject
go 1.20
此时项目已启用模块支持，后续依赖将自动记录到 go.mod 中。
添加与管理依赖版本
当导入外部包并运行构建或测试时，Go 会自动分析依赖并写入 go.mod。例如：
import "github.com/gin-gonic/gin"
执行：
go build
Go 自动下载 gin 的最新稳定版本，并在 go.mod 中添加：
require github.com/gin-gonic/gin v1.9.1
也可手动指定版本：
-
指定具体版本：
go get github.com/sirupsen/logrus@v1.8.2
-
升级到最新版：
go get -u github.com/gin-gonic/gin
-
降级版本：
go get github.com/gin-gonic/gin@v1.7.0
版本号遵循语义化版本规范（SemVer），如 v1.2.3。若仓库未打标签，Go 使用伪版本号（如 v0.0.0-20251010123456-abcdef123456）标识提交时间与哈希。
版本锁定与可复现构建
go.mod 记录所需模块及版本，而 go.sum 文件则保存每个模块的校验和，用于验证完整性。这两个文件应提交到版本控制系统中。
要确保构建一致性：
- 不随意修改 go.mod 中的版本
- 定期运行
go mod tidy 清理未使用的依赖
- 使用
go mod verify 检查模块是否被篡改
在 CI/CD 环境中，只需克隆代码并运行 go build，即可还原完全一致的依赖环境。
处理主版本升级与兼容性
Go 模块通过版本号中的主版本（如 v1, v2）决定导入路径。若使用 v2 及以上版本，必须在模块路径末尾加上 /vN：
require github.com/example/lib/v2 v2.1.0
对应导入语句也需调整：
import "github.com/example/lib/v2"
这是为了支持多版本共存，避免破坏性变更影响旧代码。
基本上就这些。合理使用 go.mod 和 go get 命令，结合语义化版本管理，就能高效维护 Golang 项目的依赖关系。
关注官方公众号