Java 紧凑源文件怎样直接运行单文件程序

如果目标只是写一个几行的 Java 命令程序，可以在 Java 25 中省略显式的 class、public 和 static，把文件保存为 HelloWorld.java 后直接执行 java HelloWorld.java。这类文件称为紧凑源文件，启动器会把文件里的顶层成员放进一个隐式声明类，再寻找可启动的 main 方法。

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

最小可用边界是：使用 JDK 25，文件中存在返回 void 的可访问 main(String[]) 或 main()。前者优先；如果选中的是实例 main，java 启动器会先创建隐式类的默认实例再调用它。

先确认这项写法解决什么问题

紧凑源文件适合一次性脚本、课堂示例、命令行小工具和临时验证。它减少的是单文件程序的外层样板，不是把 Java 变成另一种语言。Java 25 官方文档把“紧凑源文件”和“实例 main 方法”作为永久语言特性说明；此前版本的预览名称和细节不能直接当作当前规则。

需要注意两个边界：第一，本文示例按 Java 25 编写；第二，隐式声明类不能在 Java 源码中用名字引用，也不能直接构造，因此它更适合作为独立入口，而不是供其他类调用的公共 API。

用最小实例 main 写出单文件程序

创建 HelloWorld.java，文件内容可以只有一个顶层方法：

void main() {
    // IO 是 Java 25 提供的基础控制台 I/O 类，用于输出一行文本。
    IO.println("Hello, Java 25");
}

这里没有显式 class，也没有 public static void main(String[] args)。顶层方法会成为隐式声明类的实例方法，void main() 满足启动器的无参入口形态。Java 25 中 IO 位于 java.lang，但它的静态方法不会自动静态导入，所以写成 IO.println 更明确。

用 java 命令直接运行源文件

在保存文件的目录执行下面的命令。注释只说明命令的目的，不代表需要输入到终端：

# 直接让 java 启动器读取、编译并启动这个源文件
java HelloWorld.java

源文件模式会为本次启动准备对应的类文件，不要求你先手动输入 javac。如果希望把编译和运行拆开，也可以使用普通的两段式命令：

# 先显式编译紧凑源文件，再运行编译得到的入口类
javac HelloWorld.java
java HelloWorld

两种方式使用的是同一套 main 选择规则。直接运行适合短小程序；拆开编译适合需要保留编译产物、把编译纳入脚本或进一步观察类文件的场景。无论采用哪种方式，都不要把 HelloWorld 当成源代码里可引用的显式类名。

带参数时怎样写实例 main

如果程序要接收命令行参数，可以保留实例方法形式，只增加 String[] 参数：

void main(String[] args) {
    // 先处理参数数量，避免直接读取 args[0] 导致越界。
    if (args.length == 0) {
        IO.println("请传入一个名字");
        return;
    }
    // String[] 参数来自 java 命令后面的参数列表。
    IO.println("Hello, " + args[0]);
}

运行时可以把参数写在源文件名后面：

# 源文件名后面的值会进入 String[] args
java HelloWorld.java Ada

启动器会先检查是否存在可访问、返回 void 且带一个 String[] 参数的 main；找不到时才考虑可访问、返回 void 的无参 main。实例 main 被选中后，启动器先调用隐式声明类的无参默认构造器，再调用该实例方法。

遇到启动错误时先看这几个边界

如果启动器报告找不到可启动入口，先检查方法返回值是否为 void，参数是否严格是 String[] 或完全没有参数，以及方法是否对启动器可访问。任意其他参数形态都不能替代这两种入口。

如果命令提示语法无法识别，优先确认 java --version 使用的是 JDK 25。紧凑源文件在 Java 25 成为永久特性，不能把 Java 24 时代的预览开关和 Java 25 的正式语法混用：

# 查看当前 java 命令对应的运行时版本
java --version

还要留意自动导入范围：紧凑源文件会按需导入 java.base 导出的公共顶层类型，因此一些基础类型可以直接使用；第三方库、非 java.base 模块或有命名冲突的类型，仍然需要显式处理导入和依赖。

什么时候恢复显式 class 结构

当程序需要被其他类引用、需要命名构造器、需要多个可复用类型、需要放进命名包或开始维护稳定 API 时，应恢复普通类结构。迁移并不复杂：保留字段和方法，把它们包在一个显式 class 声明中，再根据调用关系补上访问修饰符和构造器。

可以把紧凑源文件看成一个轻量入口层，而不是长期的架构边界。小工具先用最短写法验证想法，代码开始共享或扩展后再显式表达类、包和模块，通常比一开始塞进大量样板更容易阅读。

速查表

常见问题

紧凑源文件必须写 public class 吗？

不需要。顶层字段和方法会组成隐式声明类，但文件必须提供可启动的 main 方法。

实例 main 为什么不用 static？

启动器发现实例 main 后，会先创建隐式声明类的默认实例，再调用这个实例方法，因此不需要 static。

可以在另一个 Java 类里 new 这个隐式类吗？

不可以按源代码名称直接引用它。隐式声明类没有可供源代码使用的类名，更适合独立启动入口；需要复用时应改写为显式 class。

Java 24 能直接使用本文语法吗？

不能直接按 Java 25 的正式边界判断。该能力在更早版本以预览形态演进，实际使用应以目标 JDK 的语言版本和编译器提示为准；本文示例按 Java 25 书写。