Java 25 紧凑源文件怎么跑：instance main、java.lang.IO 与普通类迁移

用 Java 写一个只有几行的命令行小工具时，最先出现的往往不是业务代码，而是 public class、static 和 String[] args。Java 25 把 Compact Source Files 和 instance main 正式带进语言体系：简单程序可以把方法直接写在源文件顶层，再用同一套 java、javac 工具直接跑起来。它很适合写脚本、教学示例和一次性诊断工具，但这不代表大型业务类可以随便省略所有结构。

Java 25 的紧凑源文件最适合“单文件、单入口、无需被其他类引用”的小程序。先用 void main() 跑通，再按需要补回类名、包名和显式依赖，迁移成本最低。

先用一个文件验证 Java 25 入口

新建 HelloTool.java，内容只保留一个实例入口和一个辅助方法：

String greeting(String name) {
    return "Hello, " + name;
}

void main() {
    IO.println(greeting("Java 25"));
}

在 JDK 25 环境中可以直接运行源文件：

java --version
java HelloTool.java

预期能看到 Java 25 的版本信息以及 Hello, Java 25。如果机器上的 java 仍是 21 或 24，源码语法和启动协议都可能不匹配，先检查 java 与 javac 是否来自同一个 JDK。

省掉的三层语法，各自去了哪里

紧凑源文件并没有发明另一种 Java 语法。编译器看到没包在类声明里的字段、方法或嵌套类型时，会把它们组合成一个隐式声明的顶层类。这个类是 final、位于 unnamed package，并且只能拥有无参默认构造器。

这也解释了一个常见误区：紧凑源文件不是把所有 Java 代码都变成“脚本语法”。方法依旧属于某个类，字段依旧有实例和静态两种成员语义，只是初学者不必先写出包围它们的类声明。

命令行参数和 IO 写法要分清

无参数入口适合固定的小实验；需要读取参数时，改成带数组参数的实例入口即可：

void main(String[] args) {
    if (args.length == 0) {
        IO.println("usage: java HelloTool.java ");
        return;
    }
    IO.println(greeting(args[0]));
}

String greeting(String name) {
    return "Hello, " + name;
}

启动协议优先选择可访问的 main(String[])；没有它时再寻找可访问的无参数 main()。两个入口都写出来并不能让程序更清晰，反而会让入口选择变成需要额外核对的条件。

Java 25 的 IO 类提供面向行的基础输入输出。这里保留 IO.println 的完整限定名，是因为 JDK 25 不再把它的静态方法名自动带入紧凑源文件；把 println(...) 直接写在方法里，不能当成默认行为。

从小工具长成普通类，什么时候该停

紧凑写法的价值在于降低入口门槛，不在于隐藏系统边界。下面这条迁移路径更适合实际项目：

1. 一个源文件、一个入口、没有外部代码需要引用：保留紧凑源文件。
2. 需要两个以上协作类型、包名或构造器参数：改成显式类。
3. 需要发布库 API、生成稳定 Javadoc 或被测试框架按类型加载：使用普通类和明确的包声明。

普通类版本可以直接从同一个逻辑演进而来：

public final class HelloTool {
    public static void main(String[] args) {
        String name = args.length == 0 ? "Java 25" : args[0];
        System.out.println(greeting(name));
    }

    private static String greeting(String name) {
        return "Hello, " + name;
    }
}

两种写法的验收重点不是代码行数，而是入口是否稳定、依赖是否明确、构建工具是否能识别它。紧凑源文件的隐式类不能按名字从其他源文件引用，这一点是从脚本转成项目代码时最容易踩到的边界。

编译失败时按这张清单定位

• 版本不对：分别执行 java --version 和 javac --version，确认主版本都是 25。
• 入口不被识别：检查 main 返回值是否为 void，参数是否为零个或单个 String[]。
• 输出方法报错：使用 IO.println 或显式导入对应静态方法，不要假设裸写 println 一定存在。
• 想在别的类里引用它：停止使用紧凑源文件，建立有名字、有包声明的显式类。
• 构建工具行为不一致：先用命令行 java HelloTool.java 验证语言特性，再确认 IDE、Maven 或 Gradle 的 toolchain 指向 JDK 25。

相关问题

Java 25 的紧凑源文件需要开启预览参数吗？

不需要。Compact Source Files 和 instance main 在 JDK 25 中是正式特性；仍应确认实际运行的 JDK 主版本。

紧凑源文件能声明 package 吗？

不能把它当成普通具名类使用。隐式声明的类位于 unnamed package，出现稳定包边界需求时应改写为显式类。

可以继续使用传统的 static main 吗？

可以。紧凑源文件支持可启动的静态入口；instance main 只是为小程序提供了更短的入口形式。

IDE 里不能运行，命令行能运行，先查什么？

先看 IDE 项目的 SDK、语言级别和 Maven/Gradle toolchain，再检查运行配置是否把源文件当作 Java 25 单文件入口。

Java 25 的这项变化适合把“写一段代码并立即运行”的反馈周期缩短。等程序开始拥有可复用类型、稳定包名和对外 API，再把省略的结构补回来，代码会比一开始就套用大型项目骨架更容易验证。