Java ModuleDescriptor.Version 怎样比较模块版本

Java 比较模块版本，可以先调用 ModuleDescriptor.Version.parse 得到版本对象，再用 compareTo 判断大小。返回负数表示左侧较小，零表示按模块版本规则相等，正数表示左侧较大；不要直接按字符串排序，也不要只判断返回值是否恰好等于 -1 或 1。

Java 官方学习入口：https://dev.java/learn/

准备一个只比较版本的程序

这个小实验只处理版本字符串，不扫描 JAR，不加载模块，也不选择依赖。准备支持模块 API 的 JDK，导入 java.lang.module.ModuleDescriptor.Version。本文以 Java SE 26 API 文档中的约定为依据，不需要开启预览特性。

先把一个容易出错的输入对放在纸上：4.12 和 4.9。若把它们当普通字符串，字符比较与数字段比较会出现不同结果。问题应交给已经定义好模块版本语义的类型处理，而不是靠补零或拆字符串临时修补。

用 parse 和 compareTo 建立比较函数

将下面代码保存为 ModuleVersionDemo.java。比较函数保持很小，展示函数负责把结果转成关系符号，并把非法输入单独报告。这样以后接入清单时，可以替换展示方式而保留比较逻辑。

import java.lang.module.ModuleDescriptor.Version;

public class ModuleVersionDemo {
    static int compare(String left, String right) {
        // 交给模块版本解析器处理分段，不使用字符串字典序。
        return Version.parse(left).compareTo(Version.parse(right));
    }

    static void show(String left, String right) {
        try {
            // 只保留返回值的符号，避免依赖具体负数或正数。
            int sign = Integer.signum(compare(left, right));
            String relation = sign  0 ? ">" : "=";
            System.out.println(left + " " + relation + " " + right);
        } catch (IllegalArgumentException ex) {
            // 坏数据单独报告，不把解析失败误当作版本相等。
            System.out.println("无法解析版本：" + left + " / " + right);
        }
    }

    public static void main(String[] args) {
        show("4.12", "4.9");
        show("4.0.0", "4");
        show("4.0-rc1", "4.0");
        show("4.0+7", "4.0+12");
        show("", "4.0");
    }
}

不要在捕获异常后返回零。假如一条版本为空，另一条是有效版本，“无法比较”和“二者相等”是两种不同状态。批量清单可以为失败项增加错误列，避免它静默混进已排序的有效版本中。

运行示例并对照四组预期关系

在保存源码的目录执行：

# 使用 UTF-8 编译，保留示例中的中文提示。
javac -encoding UTF-8 ModuleVersionDemo.java
# 运行刚才生成的类，不需要额外模块参数。
java ModuleVersionDemo

按 API 规则，前四组应分别呈现下表关系；最后一组应进入无法解析分支。这些是供读者运行对照的预期值，本文没有把示例描述为本机实测。

版本由版本号、可选预发布部分和可选构建部分组成，比较会考虑各部分的 token。不能仅凭字符串带有加号，就推断后面内容完全不参与排序。这个 API 定义的是 Java 模块版本规则，不能不加判断地用于其他版本协议。

把比较规则接入实际模块清单

建议在清单里保留原始版本文本，并另存解析成功与否。展示时需要原始文本，比较时使用版本对象；不要先按字符长度补零、去掉后缀或改写输入，再宣称得到了模块版本的原始比较结果。

一个适合扩展的小练习，是把上述输入对放进表格，每行记录原始左值、右值、关系和错误状态。然后补充项目真正遇到的版本样本，明确哪些输入属于模块版本，哪些只是外部系统自定义的发布标签。先划定输入范围，再决定是否采用同一种比较器。

toString() 返回用于解析的原始字符串，因此版本比较相等不要求原始文本完全一致。例如表中的尾零案例，文本仍可用于展示，却不应仅因字符不同就被判定为两个有先后顺序的模块版本。

示例只生成本目录下的 ModuleVersionDemo.class，没有打开文件流或创建后台服务。练习结束后可删除这个编译产物；保留源码便于以后对照项目输入。

常见问题

为什么不直接用 String.compareTo？

它比较字符顺序，不理解模块版本中的数字 token、预发布和构建部分。示例中的 4.12 与 4.9 就能展示差别。

compareTo 返回 -3 是不是错误？

不是。约定关注负、零、正，而不是具体绝对值。可以像示例一样使用 Integer.signum 转成关系判断。

parse 能解析就说明两个模块兼容吗？

不能。这里只判断版本文本的可解析性和排序关系，API 兼容、依赖选择与运行时行为需要其他依据。

参考：Java SE 26 ModuleDescriptor.Version API。