4. 共享库版本管理基础：Git分支策略、Tag标签、版本号语义化规范(SemVer)

在Jenkins共享库的准入体系中，版本管理是基石。没有清晰的分支策略、规范的标签命名和语义化的版本号，共享库的发布、回滚与依赖管理将陷入混乱。本节将系统讲解这三项核心基础，为后续的版本准入规则奠定可执行的技术前提。

4.1 Git分支策略：共享库的协作模型

共享库的代码仓库需要一套轻量但严格的分支策略，以区分开发、集成与发布阶段。推荐采用Trunk-Based Development（主干开发）结合短期特性分支的模式，避免长期并行分支带来的合并灾难。

4.2 Tag标签：不可变的发布锚点

Git Tag 是共享库版本准入的唯一不可变锚点。与分支不同，Tag 一旦创建就不应被修改或删除（除非极端情况）。Jenkins 共享库的消费者（如 Jenkinsfile）通过引用特定的 Tag 来锁定依赖版本，确保构建的可复现性。

4.2.1 Tag命名规范

推荐采用 v 前缀 + 语义化版本号的格式，例如 v1.2.3。这种命名方式与 SemVer 标准天然对齐，且易于在 Jenkins 流水线中通过正则表达式进行匹配和校验。

4.3 版本号语义化规范（SemVer）

语义化版本控制（Semantic Versioning，简称 SemVer）是共享库版本管理的核心标准。它通过 主版本号.次版本号.修订号 的三段式结构，向使用者传递明确的兼容性信号。

4.3.1 SemVer 核心规则

给定一个版本号 MAJOR.MINOR.PATCH，每次版本号的递增必须遵循以下规则：

• MAJOR（主版本号）：当做了不兼容的 API 修改时递增。例如：修改了共享库中公开函数的签名、删除了某个步骤、改变了默认行为。
• MINOR（次版本号）：当以向后兼容的方式添加功能时递增。例如：新增一个步骤、增加一个可选参数、扩展了某个功能。
• PATCH（修订号）：当做了向后兼容的问题修正时递增。例如：修复了一个 bug、优化了性能、更新了文档。

4.3.2 预发布版本与构建元数据

SemVer 还支持预发布版本和构建元数据，用于标识非稳定版本或CI自动构建的版本：

4.4 版本准入的基线规则

基于上述分支策略、Tag 规范和 SemVer 标准，我们可以定义共享库版本准入的基线规则。这些规则将在后续章节中通过 Jenkins Pipeline 实现自动化校验。

1. Tag 必须符合 SemVer 格式：正则表达式 ^v?[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$ 用于校验。
2. Tag 必须指向 main 分支：只有从 main 分支创建的 Tag 才被视为正式发布版本。
3. 版本号必须递增：新 Tag 的版本号必须大于仓库中已存在的最大 Tag 版本号。
4. 预发布版本不可用于生产：包含 - 预发布标识的 Tag 只能用于测试环境。
5. 禁止重复 Tag：不允许创建与已有 Tag 完全相同的版本号。