P16 · IDEA 启动报错：找不到或无法加载主类

场景还原：在 IDEA 里右键类名，点了 "Run 'MainApp.main()'"，结果控制台没跑起来，而是一行红字：

错误: 找不到或无法加载主类 MainApp，下面还跟着 Caused by: java.lang.ClassNotFoundException: MainApp

明明代码就在眼前，类名也没拼错，怎么就"找不到"了？------多半是类在包里，你却在包外面找它（或者根本没编译出 .class）。

一、问题现象

把 MainApp 放进 com.demo 包，编译后却在包外直接 java MainApp（等于 IDEA 里 Run Configuration 的主类写错/没编译），真实报错：

复制代码

错误: 找不到或无法加载主类 MainApp
原因: java.lang.ClassNotFoundException: MainApp

而正确写法（带全限定类名运行）则正常启动：

复制代码

程序启动成功，开始干活 ...
Args: []

二、出错代码

java 复制代码

// 文件路径: com/demo/MainApp.java ------ MainApp 在 com.demo 包里！
package com.demo;

public class MainApp {
    public static void main(String[] args) {
        System.out.println("程序启动成功，开始干活 ...");
    }
}

bash 复制代码

# ❌ 错误运行方式：没带包名（IDEA 里相当于 Run Configuration 的主类填成了 MainApp）
java MainApp
# 错误: 找不到或无法加载主类 MainApp

# ✅ 正确运行方式：要用全限定类名 com.demo.MainApp，且 classpath 指向类文件的根目录
java -cp out com.demo.MainApp

三、为什么会这样

Java 运行程序找"主类"的规则很死板：类的"全名" = 包名 + 类名 （com.demo.MainApp），并且 .class 文件必须放在和包名对应的目录结构 里（out/com/demo/MainApp.class）。

java MainApp 的意思是"在 classpath 根目录下找 MainApp.class"------但类实际在 com/demo/ 子目录里，根目录下根本没有 MainApp.class，于是 ClassNotFoundException。

IDEA 里这个报错最常见的三个真实原因：

Run Configuration 主类配置错（选了没 main 的类 / 类被移动了包没更新配置）；

项目没编译/编译输出丢失：IDEA 的 out 目录被清空或编译失败，没有 .class 文件可加载；

main 方法签名不对 ：IDEA 认为它不是可运行主类（比如写成了 static void main，漏了 public，或参数不是 String[] args）。

四、怎么解决

第一步：先确认 main 方法签名绝对标准（少一个关键字 IDEA 就不认）：

java 复制代码

// ✅ 必须是这个签名：public static void main(String[] args)
public class MainApp {
    public static void main(String[] args) {   // 一个词都不能少
        System.out.println("程序启动");
    }
}

第二步：清理 + 重新编译 （处理"没编译出 .class"）：IDEA 菜单 Build → Rebuild Project，或删掉 out 目录再 Build。

第三步：检查 Run Configuration ：Run → Edit Configurations：

Main class 填全限定类名 （com.demo.MainApp，不是 MainApp）；
不确定就点右边的文件夹图标，从列表里选类，别手敲。

第四步：命令行自查（确认是环境问题还是配置问题）：

bash 复制代码

# 编译到 out 目录
javac -d out com/demo/MainApp.java
# 从 out 的父目录用全限定类名运行
java -cp out com.demo.MainApp

能跑通 → 代码没问题，是 IDEA 配置问题，回到第二三步；跑不通 → 看是不是类路径/文件位置问题。

第五步：包结构乱了的情况 ------检查 src 目录结构是不是 com/demo/MainApp.java（和 package com.demo; 对应），别把 java 文件放错层级（比如放到 src 根目录还写 package com.demo）。

五、防坑总结

main 方法签名必须是 public static void main(String[] args)，漏 public 是最隐蔽的坑；
有包的类，运行时要用全限定类名（com.demo.MainApp），classpath 指到包的上一级；
IDEA 里 Run Configuration 的 Main class 用下拉选择，别手打；
报找不到主类先 Build → Rebuild Project，排除"没编译"；
移动/重命名类后记得更新 Run Configuration。

下一篇：P17 · 程序包不存在 / 找不到符号（依赖没导入）