单文件源码启动：java Hello.java

最小用法：源码文件就是程序01

JDK 11 的 java 启动器支持源码文件模式：第一个非选项参数以 .java 结尾时，启动器调用内置编译器编译并运行，不写出 class 文件。

public class Hello {
    public static void main(String[] args) {
        System.out.println("hello " + (args.length == 0 ? "world" : args[0]));
    }
}

java Hello.java Java 11

hello Java

运行结束后目录里仍然只有 Hello.java，没有 Hello.class。如果需要给别的程序引用，仍然要用 javac 编译出 class 或 jar。

入口类、文件名与多顶层类02

源码模式不要求文件名与 public 类名一致。启动器会执行源文件中第一个顶层类的 main 方法；文件里可以有多个顶层类作为辅助类。

public class First {
    public static void main(String[] args) {
        System.out.println("first " + Helper.value());
    }
}

class Helper {
    static String value() { return "helper"; }
}

java Multi.java

first helper

• 第一个顶层类必须有 main(String[])；后面的类只作为辅助类参与编译。
• 文件名不必与 public 类名一致；这与 javac 的规则不同。
• 源文件可以带 package 声明，启动器仍能运行；不需要把文件放进与包名匹配的目录。
• 只支持一个源文件。需要多个源文件互相引用时，用 javac 或构建工具。
• JDK 11 不支持从标准输入读取源码，也不支持一次传入多个源文件。

package demo;

public class Packaged {
    public static void main(String[] args) {
        System.out.println("packaged");
    }
}

java Packaged.java

packaged

shebang 与 --source：把 Java 当脚本03

在 Unix 上，源码文件可以带 shebang 行，用 --source 指定语言版本，然后直接执行。启动器会跳过第一行 #!。

#!/usr/bin/java --source 11
public class Script {
    public static void main(String[] args) {
        System.out.println("script " + args.length);
    }
}

chmod +x script
./script a b

# Windows 上没有 shebang，但可以用 --source 运行无后缀文件
java --source 11 script a b

script 2

shebang 是 Unix 的能力，不是 Java 语言语法；在 Windows 上直接双击或执行无后缀文件不会生效，必须显式调用 java --source 11 script。

依赖：用 --class-path 挂 classpath04

单文件源码可以依赖 classpath 上已编译的类。把依赖 jar 或 class 目录传给 --class-path，源文件本身仍只有一个。

public class Lib {
    public static String msg() { return "from lib"; }
}

javac -d lib Lib.java

cat > UseLib.java <<'EOF'
public class UseLib {
    public static void main(String[] args) {
        System.out.println(Lib.msg());
    }
}
EOF

java --class-path lib UseLib.java

from lib

这适合「一个脚本 + 几个已有 jar」的场景。依赖一多、需要模块化或需要可重复构建时，应该回到 Maven / Gradle / javac。

边界：它不是构建工具的替代品05

• JEP 330 在 JDK 11 引入；JDK 10 及更早没有这个能力。
• 只支持单个源文件；多文件源码启动是 JDK 22 的 JEP 458，不要提前使用。
• 不生成 class 文件，无法做传统的增量构建或产物校验。
• 启动时多一次编译，短脚本无感，大型程序不适合。
• 生产环境仍应使用 javac / 构建工具，把编译与运行分离。

版本边界BOUNDARY

这张表比 API 本身更值得记。写代码时先确认你的运行时版本。

费曼自检SELF CHECK

先合上页面，用自己的话回答，再展开对照。能讲出因果和反例，才算真正掌握。