Java程序需先用javac编译为.class文件再用java命令运行;类路径、main方法签名、JDK版本必须严格符合规范,否则报错。

Java程序必须先编译成.class文件才能运行
Java不是脚本语言,java命令不能直接执行.java源文件(除非用java 11+的“单文件源代码执行”特性,但那是特例,不推荐用于学习或生产)。你得先用javac把源码编译出来。
常见错误:直接敲java HelloWorld.java,报错Error: Could not find or load main class HelloWorld.java——因为java命令只认.class,不认.java。
- 确保当前目录下有
HelloWorld.java,且类名与文件名严格一致(含大小写) - 运行
javac HelloWorld.java,成功后会生成HelloWorld.class - 再运行
java HelloWorld(注意:这里不加.class后缀,也不写.java) - 如果类在包中(如
package com.example;),则.class必须放在对应子目录(com/example/HelloWorld.class),且需从包根路径运行:java com.example.HelloWorld
java命令找不到主类?检查CLASSPATH和当前路径
报错Could not find or load main class XXX,90%不是代码问题,而是类路径没对。默认情况下,java只在当前目录(.)查找类,不会自动包含子目录或src目录。
典型陷阱:
立即学习“Java免费学习笔记(深入)”;
- 你在
src/目录下编译了javac HelloWorld.java,生成了src/HelloWorld.class,但随后在src/里执行java HelloWorld——这没问题;可如果你退到项目根目录执行java HelloWorld,就会失败 - 用了
-cp或CLASSPATH环境变量,却忘了包含当前目录:java -cp "lib/*" HelloWorld会忽略.,必须显式加上:java -cp ".;lib/*" HelloWorld(Windows)或java -cp ".:lib/*" HelloWorld(macOS/Linux) -
CLASSPATH环境变量设置了值,会覆盖默认的.,建议初学者清空它:unset CLASSPATH(Linux/macOS)或set CLASSPATH=(Windows)
为什么main方法必须是public static void main(String[] args)?
这不是约定,是JVM启动规范的硬性要求。任何偏差都会导致NoClassDefFoundError或NoSuchMethodError。
关键点:
- 方法名必须是
main,大小写敏感;写成Main或main2都不行 - 必须是
public:JVM需要从外部访问它 - 必须是
static:JVM不创建实例就调用,所以不能依赖对象状态 - 返回类型必须是
void:JVM不处理返回值;写int main(...)会直接拒绝加载 - 参数必须是
String[] args,等价于String... args;但Object[] args或String args(少一个方括号)都不合法
用java -version和which java确认实际运行的是哪个JDK
很多人装了多个JDK(如系统自带、SDKMAN、IDE内嵌、Homebrew),但java命令可能指向意料之外的版本,导致编译运行不一致。
排查步骤:
- 运行
java -version和javac -version,确认二者版本一致(否则可能编译出高版本字节码,低版本JVM无法运行) - 查路径:
which java(macOS/Linux)或where java(Windows),看输出是不是你期望的JDK下的bin目录 - 检查
JAVA_HOME是否设置正确:echo $JAVA_HOME(Linux/macOS)或echo %JAVA_HOME%(Windows);它应该指向JDK根目录(不是JRE,也不是bin子目录) - IDE(如IntelliJ)可能用自己的JDK运行程序,和命令行无关——调试时务必区分清楚运行环境
CLASSPATH的隐式覆盖和JAVA_HOME与PATH的错位,这两处一出问题,现象就是“明明代码没错,就是跑不起来”。









