版本号比较别按字符串比,这个Java工具类7个方法按SemVer来

简介: 这是一个严格遵循 SemVer 2.0.0 规范的 Java 版本号比较工具类,支持 `compare`、`gt`、`lt`、`ge`、`le`、`inRange` 和 `sortAsc` 等 7 种语义化比对能力,兼容 v 前缀、缺段补零、前导零、预发布/构建元信息等边界场景,要求 JDK 17+。

📋 目录

一、工具类功能

按 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,同样两个串按字符串字典序判出的却是 -1
  • compare("1.2", "1.2.0") 段数不足按 0 补齐,拿到 0
  • compare("v1.2.3", "1.2.3") 前缀不参与比较,拿到 0
  • compare("1.02.3", "1.2.3") 前导零按数值判等,拿到 0
  • compare("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") 日期式写法可比,拿到 1
  • compare("1.0.99999999999999999999", "1.0.100000000000000000000") 超出 long 的段值仍按十进制数值比,拿到 -1
  • compare("1.0.0+build-1", "1.0.0") 拿到 0,+build-1 被当成构建元信息而不是预发布
  • compare("1.0.0+build-1", "1.0.0-1") 拿到 1
  • compare(null, "1.0.0") 抛 版本号不能为空
  • compare("1..2", "1.0.0") 抛 版本号段为空: 1..2
  • compare("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") 拿到 true
  • gt("1.9.9", "2.0.0") 拿到 false,1.x 修得再高也越不过 2.0.0
  • gt("1.2", "1.2.0") 判等的两个写法,拿到 false
  • gt(" ", "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") 拿到 true
  • lt("1.0.0-alpha", "1.0.0-alpha.1") 拿到 true
  • lt("1.2", "1.2.0") 判等的两个写法,拿到 false
  • lt("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") 拿到 true
  • inRange("1.0.0", "1.0.0", "2.0.0") 下限含在内,拿到 true
  • inRange("2.0.1", "1.0.0", "2.0.0") 拿到 false
  • inRange("1.0.0-rc.1", "1.0.0", "2.0.0") 预发布低于下限,拿到 false
  • inRange("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 元素时抛 版本号不能为空

四、工具类源码(可直接复制)

📦 源码文件

相关文章
|
4天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1770 3
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
4天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
3774 0
|
19天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8819 58
|
14天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3117 9
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5866 69
|
7天前
|
云安全 人工智能 安全
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1959 2