Java 25 简洁源文件与实例 main 的启动入口配置方法

我第一次把 Java 25 的小工具改成简洁源文件时，最容易误判的不是语法，而是启动入口：文件里可以没有显式 class，但仍然必须存在一个符合启动协议的 main。JEP 512 在 Java 25 已经是正式能力，JDK 25 不需要为它额外打开预览开关。

官方资料：https://docs.oracle.com/en/java/javase/25/language/compact-source-files-instance-main-methods.html

一、先分清正式能力和旧预览开关

JEP 512 的完整名称是 Compact Source Files and Instance main Methods。Java 25 把它列为正式语言特性，因此下面的命令可以直接使用 JDK 25 的默认规则。--enable-preview 只属于仍处于预览状态的语言能力；把它机械加到 Java 25 的简洁源文件上，反而会让排查变得混乱。

可以先确认当前工具链，避免编辑器使用了旧 JDK：

# 确认 java 与 javac 来自同一个 JDK 25
java --version
javac --version

二、用一个文件声明实例 main 入口

文件名保存为 HelloWorld.java。顶层的字段和方法会被视为一个隐式声明类的成员，最小入口可以只写一个无参数实例方法：

// 顶层方法属于隐式声明类，省略显式 class 声明
void main() {
    // IO.println 是 Java 25 小程序更简洁的输出方式
    IO.println("Hello, Java 25");
}

这里的 main 不是静态方法，但启动器会先创建隐式类的默认实例，再调用这个实例方法。若需要读取命令行参数，可以改成：

// 参数形式仍然由启动器传入命令行参数数组
void main(String[] args) {
    // 没有参数时也给出明确结果，避免直接访问 args[0]
    String name = args.length == 0 ? "Java" : args[0];
    IO.println("Hello, " + name);
}

三、选择直接运行还是显式编译

调试小工具时，直接把源文件交给 java 最省事：

# 让 Java 启动器编译并运行单文件源代码
java HelloWorld.java

需要把编译产物交给脚本、容器或后续任务时，再拆成两步：

# 指定输出目录，避免 class 文件散落在源码目录
mkdir -p out
javac -d out HelloWorld.java
# 把输出目录加入类路径后启动隐式类
java -cp out HelloWorld

隐式类名通常由文件名推导，但它不能在源代码里按普通类名引用；这也是简洁源文件更适合“一个文件就是一个程序入口”的原因。

四、main 找不到时检查这张边界表

启动失败时不要先怀疑 IO.println。启动器先寻找可访问、返回值为 void 的 main：优先匹配带一个 String[] 参数的形式，否则匹配无参数形式。方法可以是静态或实例方法，也不再强制要求 public。

如果程序依赖第三方库、需要稳定的包名、多个构造器或会被其他类复用，就不应继续堆在简洁源文件里。把现有顶层成员包进显式类声明，是更容易维护的迁移边界。

常见问题

Java 25 简洁源文件还要加 --enable-preview 吗？

不需要。JEP 512 在 Java 25 已正式发布；只有使用早期 JDK 的预览实现时，才按那个版本的编译与运行要求处理。

为什么写了 main 还是不能启动？

先核对返回值是否为 void、参数是否为零个或 String[]，再确认实际执行的 java 与 javac 都是 JDK 25。

简洁源文件能不能被另一个类 new 出来？

不适合这样使用。隐式声明类不能按名字直接引用，简洁源文件的定位是独立程序入口；需要复用时应恢复显式类和包结构。

我的取舍是：一次性脚本、课堂示例和小型命令行工具用简洁源文件很舒服；一旦出现稳定 API、依赖注入或多人维护，尽早恢复显式 class，入口反而更清楚。