笔记:《语义化版本》速记口令
FastAdmin #版本管理
语义化版本
版本号管理是项目管理中的重中之重,如果版本号管理混乱,会导致项目冲突,引发项目灾难,严重的还会导致项目失败。
《语义化版本》规范就是为了避免这些问题,但是很多小伙伴看着长长规范,进而产生了抵抗心理,这里整理了一个简单的速记口令,只需要简单的六个字就可以快速理解《语义化版本》规范的精髓,以下供大家参考。
v1.2.3
速记口令:1重2新3修
- 重构,允许不兼容的重构,可以和上一个版做不兼容的代码重构。
- 新增,新增功能,同时修复 Bug,可以对现有代码做兼容的重构,必须充分测试而且需要完全兼容前一版本。
- 修复,修复 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-04-29
《语义化版本》规范文档 https://semver.org/
标签:语义,口令,升级,v1.0,版本,速记,兼容 From: https://www.cnblogs.com/F4NNIU/p/semver-note.html