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。