Go模块通过语义化版本管理依赖，确保构建一致性。初始化项目后，使用git tag标记版本（如v1.0.0），依赖自动写入go.mod；升级依赖用go get指定版本或提交，主版本变更需调整模块路径（如/v2）；发布新版本时遵循补丁、次版本、主版本规则打标签，外部项目按版本号引用，保持依赖清晰可控。

Go 模块使用语义化版本（Semantic Versioning）来管理依赖，确保项目在不同环境中的一致性和可重复构建。下面通过一个实际示例说明如何在 Go 项目中正确使用模块和语义化版本控制。

初始化模块并设置版本

创建一个新项目目录，并使用 go mod init 初始化模块：

mkdir myproject
cd myproject
go mod init example.com/myproject

此时会生成 go.mod 文件，内容类似：

module example.com/myproject

go 1.20

当你发布第一个稳定版本时，应打上 v1.0.0 标签：

立即学习“go语言免费学习笔记（深入）”；

git init
git add .
git commit -m "init project"
git tag v1.0.0
git push origin v1.0.0

依赖模块的版本选择

假设你的项目依赖 github.com/sirupsen/logrus，你可以通过 import 并运行 go mod tidy 自动添加依赖：

main.go 中引入：

package main

import (
  "github.com/sirupsen/logrus"
)

func main() {
  logrus.Info("Hello, versioned world!")
}

然后执行：

go mod tidy

go.mod 会自动更新，包含类似内容：

GitHub Push 自动推送

使用自动 SSH 和远程配置实现安全的 GitHub 推送自动化。适用于执行 `git push`、自动化推送或处理冲突等场景。

下载

module example.com/myproject

go 1.20

require github.com/sirupsen/logrus v1.9.0

Go 默认选择最新的稳定版本（遵循语义化版本规则），v1.9.0 表示主版本 1，次版本 9，补丁 0。

升级或降级依赖版本

要将 logrus 升级到更新的版本（如 v1.9.3）：

go get github.com/sirupsen/logrus@v1.9.3

若想使用特定提交：

go get github.com/sirupsen/logrus@e4a908ff

go.mod 中的版本号会相应更新。注意：主版本号变更（如 v2.x.x）需要模块路径包含 /v2 后缀，例如：

require github.com/some/module/v2 v2.1.0

发布你自己的模块版本

当你的模块需要对外提供时，其他项目将按语义化版本拉取：

• 修复 bug，不破坏 API：v1.0.1 → v1.0.2（补丁版本）
• 新增功能，向后兼容：v1.0.2 → v1.1.0（次版本）
• 重大变更，API 不兼容：v1.1.0 → v2.0.0（主版本）

每次发布新版本都需打 git tag：

git tag v1.1.0
git push origin v1.1.0

外部项目可通过指定版本使用：

require example.com/myproject v1.1.0

基本上就这些。Go 模块结合语义化版本，让依赖管理清晰可控。关键在于遵循版本规则，合理打标签，保持 go.mod 和 go.sum 的整洁。不复杂但容易忽略细节。