Question

语义化的版本模式

可将工程分为项目 project 和 产品 product。

• 项目级版本号：日期，如 $project-2019.11.12
• 产品级版本号： major-minjor-patchlevel ，其中偶数 minjor 表示稳定版本，奇数 minjor 表示不稳定分支。如 $product-0.2.1

“语义化的版本模式”指的是在版本控制和软件开发中，采用语义化版本控制（Semantic Versioning）的策略来管理软件的版本号。这种模式的核心目的是通过版本号传达软件的更改信息，以便用户和开发者能够快速理解软件的变化内容和影响。

语义化版本控制（Semantic Versioning）

语义化版本控制通常遵循以下格式的版本号：

MAJOR.MINOR.PATCH

• MAJOR （主版本号）：当你做了不兼容的 API 修改时，增加主版本号。例如，从 1.0.0 到 2.0.0。
• MINOR （次版本号）：当你在保持向后兼容的情况下添加功能时，增加次版本号。例如，从 1.1.0 到 1.2.0。
• PATCH （修补版本号）：当你做了向后兼容的问题修正时，增加修补版本号。例如，从 1.1.1 到 1.1.2。

额外的标识符

在某些情况下，还会使用预发布和构建元数据标识符来提供更多版本信息：

• 预发布版本 （Pre-release version）：在版本号后添加“-alpha”、“-beta”或“-rc”这样的标识符。例如，1.0.0-alpha。
• 构建元数据 （Build metadata）：在版本号后用“+”分隔添加构建元数据。例如，1.0.0+20130313144700。

示例

假设你正在开发一个软件库，当前的版本是 2.3.1。如果你修复了一个小 bug，不引入新特性或不改变现有 API，你会更新修补版本号，得到 2.3.2。如果你添加了一个新特性，并且保持向后兼容，你会更新次版本号，得到 2.4.0。如果你进行了不兼容的 API 更改，你会更新主版本号，得到 3.0.0。

这种语义化版本模式有助于清晰地传达软件的版本变动，让使用者能够做出相应的决策。例如，用户知道如果更新到一个新主版本，可能需要进行额外的代码调整或重构。