Java 22 未命名变量与模式怎么落地：忽略值、作用域和编译器验收

订单路由代码里经常出现一种尴尬：为了匹配一个 record，必须给不会再用到的字段起名；为了捕获异常，又要留下一个永远不读取的参数。Java 22 通过 JEP 456 提供了未命名变量与未命名模式，可以用下划线明确表达“这个位置需要匹配，但值不参与后续逻辑”。

先把“要匹配”和“要使用”拆开

假设路由器只关心订单状态，不关心金额。旧写法会给金额起一个看似有意义的名字，时间一长，读代码的人还要猜它是不是遗漏的业务逻辑。

record Order(String id, String status, long cents) {}

static String route(Object value) {
    return switch (value) {
        case Order(String id, String status, long cents) ->
            status + ":" + id;
        default -> "unknown";
    };
}

Java 22 可以把不需要的分量写成下划线。这里的重点不是少打几个字符，而是把“金额被匹配过，但当前决策不使用它”变成编译器可检查的意图。

static String route(Object value) {
    return switch (value) {
        case Order(String id, String status, _) ->
            status + ":" + id;
        default -> "unknown";
    };
}

三个位置适合使用下划线

record 模式：只保留真正参与分支的字段

record 模式里的下划线是未命名模式。它仍然参与类型和结构匹配，但不会把值绑定到一个可以在箭头右侧读取的名字上。订单示例中，只有 id 和 status 进入结果，金额被明确排除。

异常参数：记录失败，不读取异常对象

如果日志只需要固定错误码，异常参数本身没有价值。捕获参数可以写成未命名变量，让以后维护的人不必误以为这里需要打印堆栈。

try {
    dispatch(order);
} catch (TimeoutException _) {
    metrics.increment("order.timeout");
}

lambda 与局部变量：保留接口形状，拒绝无意义命名

有些回调接口要求两个参数，业务只用第二个。用下划线表达第一个参数不参与计算，能避免 ignored、unused 这类名字在项目里泛滥。

BiFunction label = (_, count) -> "数量=" + count;

作用域边界比语法更容易出错

未命名变量没有名字，因此不能在后续表达式里读取，也不能靠“下划线变量”跨过模式作用域。真正需要使用的值必须保留名称；只是为了通过匹配或满足声明形状的值，才应该丢弃。

static boolean isLarge(Object value) {
    return switch (value) {
        case Order(_, _, cents) -> cents >= 10_000;
        default -> false;
    };
}

这个例子保留了 cents，因为判断金额是业务结果；订单编号和状态才是未使用分量。不要为了追求“全是下划线”而牺牲可读性。

用 javac 做一轮最小验收

未命名变量依赖 Java 22 的语言规则，不能只看 IDE 是否有颜色提示。把示例放进一个独立文件夹，先用目标版本编译，再故意读取下划线确认边界。

javac --release 22 OrderRouter.java
java OrderRouter

如果项目仍以 Java 21 编译，应该把这类代码当作升级前置项，而不是在构建参数里悄悄打开旧预览开关。升级后再检查编译器、测试运行时和生产镜像是否使用同一主版本。

常见误区

• 把下划线当成可复用变量：未命名变量没有可引用的绑定。
• 只改源代码不改编译链：本地 JDK 22 能过，CI 的 --release 21 仍会失败。
• 忽略真正需要的字段：如果后续要打印订单号，就应保留 id，不要为了形式整齐改成下划线。

常见问题

Java 22 的下划线变量和以前的 unused 命名有什么区别？

unused 仍是一个普通变量，后续代码可以读取它；下划线是语言层面的未命名声明，编译器会阻止误用。

record 模式里能只忽略一个字段吗？

可以。按 record 组件顺序，把不参与判断的组件写成下划线，其他组件继续保留名字。

项目暂时不能升级到 Java 22 怎么办？

先保留兼容写法，不要把 Java 22 语法混入旧版本分支；可以用代码审查规则标出未使用模式变量，待编译链升级后一次性替换。

把忽略意图交给编译器

这项语法最适合小范围落地：先在模式匹配、异常参数和回调适配处替换明显的无用命名，再用目标版本编译和测试验证。留下名字的字段应该都有用途，写成下划线的位置也应该真的不再被读取。