笔记：《语义化版本》速记口令

笔记：《语义化版本》速记口令

FastAdmin #版本管理

语义化版本

版本号管理是项目管理中的重中之重，如果版本号管理混乱，会导致项目冲突，引发项目灾难，严重的还会导致项目失败。

《语义化版本》规范就是为了避免这些问题，但是很多小伙伴看着长长规范，进而产生了抵抗心理，这里整理了一个简单的速记口令，只需要简单的六个字就可以快速理解《语义化版本》规范的精髓，以下供大家参考。

示例：v1.2.3

速记口令：1重2新3修

1. 重构，在语义化中叫“主版本”号，这个版本的升级允许不兼容的重构，可以和上一个版做不兼容的代码重构。
2. 新增，在语义化中叫“次版本”号，允许新增功能，同时修复 Bug，可以对现有代码做兼容的重构，必须充分测试而且需要完全兼容前一版本。
3. 修复，在语义化中叫“修订版本”号，版本号升级主要是为了修复 Bug，所有功能不变，需要和前一版完全兼容，必须充分测试而且需要完全兼容前一版本。

语义化版本升级案例

前面整理关于《语义化版本》的速记口令，可能还有小伙伴对语义化还有不理解的，下面举几个升级案例来分析说明，方便大家理解，特别注意案例中的数字变化。

• 当 v1.0.1 升级到 v1.0.2 只可以修复 Bug，v1.0.2 和 v1.0.1 完全兼容，并且需要充分测试。
• 当 v1.1.x 升级到 v1.2.x ，可以新增功能，可以修复 Bug，v1.2.x 需要向下完全兼容，也就是说需要和 v1.1.x 、v1.0.x 完全兼容，并且需要充分测试。
• 当 v1.x.x 升级到 v2.x.x 可以做不兼容的重构，但是由于是同一款产品，为了项目的长远发展，需要有升级指南，或升级说明文档，方便开发者进行升级，针对终端用户的产品需要做到自动升级数据文件，做到无痛自动升级，同时对旧版本的数据进行文件备份，以便升级失败回滚。

F4nniu - FastAdmin开源后台
2023-05-06

《语义化版本》规范文档 https://semver.org/