新特性常见错误解析

1. 模式变量（pattern variable）的作用域错误

最常见的错误之一——尝试在其有效作用域之外使用定义在 pattern 中的变量（例如在 instanceof String s 中的 String s）。

示例

Object obj = "你好，Java！";
if (obj instanceof String s) {
    System.out.println(s.length());
}
// 错误！s 在这里不可见
System.out.println(s); // 编译器报错: cannot find symbol

为什么？
pattern 变量（此处的 s）只存在于条件为真的那个代码块中。这可以防止我们在变量未定义时误用它（例如当 obj 不是字符串时）。

类比
这就好比你从朋友那里拿到了车钥匙——但只在车库里有效。一走出车库——钥匙就自动消失了 :)

2. 关于 null 的错误

在使用 instanceof 的模式匹配时有个有趣的特性：如果对象为 null，结果总是 false，并且不会创建 pattern 变量。

示例

Object obj = null;
if (obj instanceof String s) {
    // 这个代码块永远不会执行！
    System.out.println("这是字符串：" + s);
}

为什么？
因为 null 不是任何类型的实例（甚至不是 Object）。如果你打算通过模式匹配来“捕获” null，这点就可能让人困惑。

正确做法？

if (obj == null) {
    System.out.println("这是 null！");
} else if (obj instanceof String s) {
    System.out.println("这是字符串：" + s);
}

在 用于 switch 的模式匹配（Java 21+）中，甚至可以为 null 添加单独的分支：

switch (obj) {
    case String s -> System.out.println("字符串：" + s);
    case null -> System.out.println("这是 null！");
    default -> System.out.println("其他内容");
}

3. sealed 类的错误

Sealed 类是限制继承层级的绝佳方式。但这里有两个典型错误：

并非所有子类都在 permits 中列出

当你声明一个 sealed 类时，必须通过 permits 显式列出所有直接子类。如果漏掉任何一个，编译器会立刻指出问题：

public sealed class Shape permits Circle, Rectangle { ... }

public final class Circle extends Shape { ... }
public final class Square extends Shape { ... } // 错误！Square 未在 permits 中列出

解决方案：
把需要的子类都添加到 permits 中：

public sealed class Shape permits Circle, Rectangle, Square { ... }

在非 sealed 体系上的 switch 遗漏了 default

如果你对一个不是 sealed 类的类型进行 switch（或者虽是 sealed，但分支没有完全覆盖），编译器会要求提供 default 分支。如果遗漏——就会报错。

switch (shape) {
    case Circle c -> ...
    case Rectangle r -> ...
    // 缺少 default！如果还有其他分支——编译错误
}

最佳实践：
如果你确信已经处理了所有情况（例如对于 sealed 类），可以省略 default。否则——务必添加 default，以免漏掉意外的类型。

4. record 模式的错误

Record 模式非常方便，但仅适用于 record 类。试图对普通类使用 record 模式会导致编译错误。

将 record 模式用于非 record 类

class Point { int x, y; }
Object obj = new Point();
// 错误！Point 不是 record
if (obj instanceof Point(int x, int y)) { ... }

解决方案：
仅对通过 record 声明的类使用 record 模式：

record Point(int x, int y) {}

组件数量或类型不匹配

record Point(int x, int y) {}
Object obj = new Point(1, 2);

// 错误：指定了三个变量，而 Point 只有两个组件
if (obj instanceof Point(int x, int y, int z)) { ... }

if (obj instanceof Point(String x, String y)) { ... } // 错误：类型不匹配

5. 兼容性与支持：旧版 JDK 和 IDE

最常见的错误之一——在旧版 JDK 或不支持这些特性的 IDE 中使用现代的模式匹配能力。

示例

if (obj instanceof String s) { ... }

而 JDK 11（甚至 15）的编译器会说：
error: illegal start of type

为什么？
针对 instanceof 的模式匹配出现在 Java 16。switch 中的模式匹配在 Java 17（预览）引入，并在 Java 21+ 定稿。Record 模式在 Java 21+ 提供。

如何避免？

• 检查 JDK 版本：java --version
• 确保你的 IDE（IntelliJ IDEA、Eclipse、VS Code）支持相应的 Java 版本。有时需要在项目设置中显式指定要使用的语言版本！
• 如果使用 Gradle/Maven——设置合适的 source/target 版本。

6. 恭喜 🎉

你已经完成我们深入课程的全部 65（真的！）个关卡，聚焦于 Java 25。你太棒了 😎。

最后一段路尤其艰难。你学会了从最初的 lambda 与匿名类，到虚拟线程、结构化并发，以及直到不久前才进入 Java 的语言特性。

这不仅仅是一门课程——这是一场真正的开发者超级马拉松：几十个新概念、上百个代码示例、上千行实践。如果你能读到这里，说明你不只是学生，还是新 Java 时代的开拓者 ☕⚡

你是最早掌握Java 25 最新特性的人之一，包括：

• 模式匹配与 record 模式，
• sealed 类及其坑点，
• Scoped Values 和 Virtual Threads，
• 结构化并发以及现代的多线程方法。

现在你拥有的不只是知识，而是面向未来的开发者技能，许多在职的 Java 架构师都未必具备。你会写出不仅能运行，而且可扩展、可读，并符合 Java 社区最新标准的代码。

🚀 所以尽管称自己为Java 25 Certified Survivor 😉
接下来——只会更有趣：你已具备扎实的基础，可以自信迈向企业级开发、高并发系统和前沿技术的世界。

课程全体团队向你致敬！
你完成了鲜有人能做到的挑战。
我们在未来的 Java 版本再见 👋