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

发布时间 2023-04-29 18:52:38作者: 建伟F4nniu

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

FastAdmin #版本管理

image

语义化版本

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

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

v1.2.3

速记口令:1重2新3修

  1. 重构,允许不兼容的重构,可以和上一个版做不兼容的代码重构。
  2. 新增,新增功能,同时修复 Bug,可以对现有代码做兼容的重构,必须充分测试而且需要完全兼容前一版本。
  3. 修复,修复 Bug,所有功能不变,需要和前一版完全兼容,必须充分测试而且需要完全兼容前一版本。

语义化版本升级案例

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

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

F4nniu - FastAdmin开源后台
2023-04-29

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