Go项目需用Git与Go Modules协同管理依赖：初始化仓库并提交，启用go mod init定义模块路径，通过go.mod/go.sum锁定版本，用go mod tidy维护依赖，Git Tag须符合语义化版本以支持go get拉取。

Go 语言原生支持模块化开发，从 Go 1.11 开始引入 go mod，不再强依赖 $GOPATH，而是通过 Git 等版本控制系统管理源码和依赖。配置好 Git + Go modules，才能稳定构建、复现和协作。

初始化 Git 仓库并规范提交结构

在项目根目录执行：

• git init 创建本地仓库
• git add . && git commit -m "feat: init project with go mod"
• 建议添加 .gitignore，至少排除 bin/、tmp/、go.sum（可选，但推荐提交）和编辑器临时文件

注意：Go 项目通常不提交 vendor/ 目录（除非有特殊离线需求），依赖由 go.mod 和 go.sum 精确锁定。

启用并初始化 Go Modules

确保环境变量 GO111MODULE=on（Go 1.16+ 默认开启）。在项目根目录运行：

• go mod init example.com/myapp —— 指定模块路径（应与未来公开地址一致，如 GitHub URL）
• 执行 go build 或 go run . 后，Go 自动分析导入语句，写入依赖到 go.mod 并生成 go.sum
• go mod tidy 清理未使用依赖、补全间接依赖，保持 go.mod 最小且准确

用 Git 管理模块依赖的版本演进

Go 不锁死依赖的 Git 提交 ID，而是通过语义化版本（v1.2.3）或伪版本（v0.0.0-20250101120000-abcdef123456）记录快照。关键操作包括：

• 升级依赖：go get github.com/some/lib@v1.5.0，然后 go mod tidy
• 回退到某次 Git 提交：go get github.com/some/lib@abcdef123456
• 替换私有模块（如内部 GitLab 库）：go mod edit -replace github.com/private/lib=gitlab.example.com/group/lib@v0.1.0
• 所有变更后，记得 git add go.mod go.sum 并提交 —— 这是复现构建的关键

发布版本并打 Git Tag

当功能稳定、准备发布时：

• 更新 go.mod 中模块路径（如从 v0.1.0 到 v1.0.0）
• 运行 git tag v1.0.0，并 git push origin v1.0.0
• 其他项目执行 go get example.com/myapp@v1.0.0 即可拉取该版本
• Tag 名必须符合语义化版本格式（vX.Y.Z），否则 Go 工具链无法识别为正式版本

Git Tag 和 go.mod 版本号协同，让依赖可追溯、可验证、可升级。