📋 目录
一、工具类功能
按 SemVer 2.0.0 口径比较版本号大小,比的是各段十进制数值而不是字符串字典序,v 前缀、缺段补 0、前导零、超出 long 的段值都能比,预发布低于正式版、构建元信息不参与判等。
二、所需环境
JDK 17或以上
三、方法与调用示例(按需调用)
🔢 方法序号:1
🎯 方法用途:
- 按语义化版本(SemVer 2.0.0 §11)的优先级比两个版本号,给出带方向的整数,而不是按字符串字典序比
- 需要知道谁大谁小、大多少方向,或者给排序提供比较逻辑时用;只问够不够格就用后面的谓词
🧩 方法定义:public static int compare(String v1, String v2)
🗣️ 入参解释:public static int compare(版本1, 版本2)
📤 返回值解释:int,负数是 v1 小于 v2,0 是判等,正数是 v1 大于 v2,只保证符号不保证绝对值
💡 边界口径:
- 数字段按十进制数值逐段比,缺的段按 0 补齐:
1.10.0大于1.9.0,1.2与1.2.0判等 v与V前缀、首尾与段间空白、前导零、+build构建元信息都不影响判等,判等只认compare(...) == 0- 同一版本号下带预发布标识的低于正式版;标识逐段比,数字段按数值且数字段小于字母段,前缀相同时段数多者优先
- 段值不限于 int 或 long,按「去前导零后先比长度、再比字典序」实现,日期式和二十位段值都能比
- 切分时先取
+再取-,1.0.0+build-1里的连字符不会被当成预发布分隔符 - null、空白、
1..2、非数字段、空预发布标识、空构建元信息都抛IllegalArgumentException,消息带原文
🧪 方法示例:
compare("1.10.0", "1.9.0")拿到1,同样两个串按字符串字典序判出的却是-1compare("1.2", "1.2.0")段数不足按 0 补齐,拿到0compare("v1.2.3", "1.2.3")前缀不参与比较,拿到0compare("1.02.3", "1.2.3")前导零按数值判等,拿到0compare("1.0.0+build.1", "1.0.0+build.2")构建元信息不参与优先级,拿到0- 规范优先级链的 12 个版本逐对验证严格递增,链形如
1.0.0-0、1.0.0-alpha、1.0.0-alpha.1 直到 1.0.0,拿到true compare("20260925.1", "20260924.9")日期式写法可比,拿到1compare("1.0.99999999999999999999", "1.0.100000000000000000000")超出 long 的段值仍按十进制数值比,拿到-1compare("1.0.0+build-1", "1.0.0")拿到0,+build-1被当成构建元信息而不是预发布compare("1.0.0+build-1", "1.0.0-1")拿到1compare(null, "1.0.0")抛版本号不能为空compare("1..2", "1.0.0")抛版本号段为空: 1..2compare("1.x.3", "1.0.0")抛版本号段必须为数字: x in 1.x.3
🔢 方法序号:2
🎯 方法用途:
- 判 v1 是否严格大于 v2,用于「高于某版本才放行」的门禁
- 客户端版本卡最低能力、接口按新版本才返回某字段时用
🧩 方法定义:public static boolean gt(String v1, String v2)
🗣️ 入参解释:public static boolean gt(版本1, 版本2)
📤 返回值解释:boolean,v1 高于 v2 时为 true
💡 边界口径:
- 就是
compare(v1, v2) > 0的语法糖,判的是优先级而不是写法 - 等号不算大于:
1.2与1.2.0判等,gt 给false,要含等号请用 ge - 任一号非法就抛
IllegalArgumentException
🧪 方法示例:
gt("2.5.1", "2.5.0")拿到truegt("1.9.9", "2.0.0")拿到false,1.x 修得再高也越不过 2.0.0gt("1.2", "1.2.0")判等的两个写法,拿到falsegt(" ", "1.0.0")抛版本号不能为空
🔢 方法序号:3
🎯 方法用途:
- 判 v1 是否严格小于 v2,用于「低于某版本就拦下来」的判断
- 强制升级、老客户端禁用某功能这类场景用它,预发布也能正确识别成更低版本
🧩 方法定义:public static boolean lt(String v1, String v2)
🗣️ 入参解释:public static boolean lt(版本1, 版本2)
📤 返回值解释:boolean,v1 低于 v2 时为 true
💡 边界口径:
- 就是
compare(v1, v2) < 0,含等号的判断请用 le - 带预发布标识的写法低于同版本号的正式版,
1.0.0-rc.1算低于1.0.0 - 预发布标识内部,数字标识低于字母标识,
1.0.0-alpha低于1.0.0-alpha.1
🧪 方法示例:
lt("1.0.0-rc.1", "1.0.0")拿到truelt("1.0.0-alpha", "1.0.0-alpha.1")拿到truelt("1.2", "1.2.0")判等的两个写法,拿到falselt("1.0.0-alpha..1", "1.0.0")抛预发布标识含空段: 1.0.0-alpha..1
🔢 方法序号:4
🎯 方法用途:
- 判 v1 是否不低于 v2,把等号留给当前版本
- 「最低支持版本」的判断用这个而不是 gt,正好卡在边界上的版本才不会被误拦
🧩 方法定义:public static boolean ge(String v1, String v2)
🗣️ 入参解释:public static boolean ge(版本1, 版本2)
📤 返回值解释:boolean,v1 高于或等于 v2 时为 true
💡 边界口径:
- 就是
compare(v1, v2) >= 0,与 gt 的唯一差别是判等也算通过 - 判等看的是版本优先级,
1.2、1.2.0、v1.2.0三者互相都满足 ge - 入参非法同样抛
IllegalArgumentException,不会因为等号而放宽校验
🧪 方法示例:
ge("1.2", "1.2.0")拿到true- 同一对入参的
gt("1.2", "1.2.0")拿到false,等号就是两者的分界
🔢 方法序号:5
🎯 方法用途:
- 判 v1 是否不高过 v2,把等号留给上限版本
- 与 ge 配对就是区间判断,或者直接用于「某版本之后不再支持」的场景
🧩 方法定义:public static boolean le(String v1, String v2)
🗣️ 入参解释:public static boolean le(版本1, 版本2)
📤 返回值解释:boolean,v1 低于或等于 v2 时为 true
💡 边界口径:
- 就是
compare(v1, v2) <= 0,与 lt 的唯一差别是判等也算通过 - 构建元信息不参与优先级,
1.0.0+build.1与1.0.0+build.2互相都满足 le - 两个谓词都为 true 时说明二者判等,判等请以
compare(...) == 0为准
🧪 方法示例:
le("1.2", "1.2.0")拿到true- 同一对入参的
lt("1.2", "1.2.0")拿到false
🔢 方法序号:6
🎯 方法用途:
- 判版本是否落在
[minInclusive, maxInclusive]闭区间内 - 灰度发布、功能开关的版本范围判断用它,两端都包含
🧩 方法定义:public static boolean inRange(String version, String minInclusive, String maxInclusive)
🗣️ 入参解释:public static boolean inRange(待判断版本, 区间下限, 区间上限)
📤 返回值解释:boolean,落在闭区间内为 true
💡 边界口径:
- 判断式是
ge(version, min) && le(version, max),下限与上限都算在区间内 - 预发布版本天然低于同版本号正式版,卡在区间下限时会被挡在外面
- 三个入参任一非法都会抛
IllegalArgumentException
🧪 方法示例:
inRange("1.5.0", "1.0.0", "2.0.0")拿到trueinRange("1.0.0", "1.0.0", "2.0.0")下限含在内,拿到trueinRange("2.0.1", "1.0.0", "2.0.0")拿到falseinRange("1.0.0-rc.1", "1.0.0", "2.0.0")预发布低于下限,拿到falseinRange("1.0.0+", "1.0.0", "2.0.0")抛构建元信息为空: 1.0.0+
🔢 方法序号:7
🎯 方法用途:
- 把一串版本号按优先级升序排好,返回不可变的新列表,入参集合不被修改
- 整理发布记录、取最新版本前先排序、把配置里的版本列表归一成时间线时用
🧩 方法定义:public static List<String> sortAsc(Collection<String> versions)
🗣️ 入参解释:public static List<String> sortAsc(版本集合)
📤 返回值解释:List<String>,升序的不可变新列表,元素是调用方原样给的写法
💡 边界口径:
- 入参是任意
Collection,Set也直接收;集合本身为 null 抛异常,元素里有 null 或非法版本号同样抛 - 每个版本号只解析一次再排序,比把比较器直接交给 sort 少掉重复解析
- 判等的不同写法保持原有先后,
1.2.0与1.2谁在前取决于入参顺序 - 返回值来自
List.copyOf,要再增删得自己拷一份 - 想原地排序可以用公开字段
VERSION_COMPARATOR交给list.sort
🧪 方法示例:
sortAsc(released)拿到[1.0.0-rc.1, 1.0.1, 1.2.0, 1.2, v1.9.0, 1.10.0, 2.0.0+b3]- 排序后入参列表与备份逐元素比对,拿到
true,原集合没被改动 - 结果里同时留着
v1.9.0、2.0.0+b3、1.2三种原始写法,检查是否都在,拿到true sortAsc(List.of("1.0.0+b2", "v1.0.0", " 1.0.0 "))三个判等的写法保持原有先后,拿到true- 用
VERSION_COMPARATOR原地排序后与 sortAsc 的结果比对,拿到true - 把含重复项的
Set传进去,去重后拿到[1.0.0, 2.0.0] sortAsc(List.of())空集合拿到[]sortAsc(Set.of("1.0.0"))单元素拿到[1.0.0]sortAsc(null)抛版本集合不能为null- 集合里混进一个 null 元素时抛
版本号不能为空
四、工具类源码(可直接复制)
📦 源码文件