jar是否含module-info.class决定其路径：有则必须放--module-path，无则只能放-cp；混用会导致类加载失败或模块解析错误。
模块路径和类路径，到底该往哪放JAR？
Java 9+ 启动时，--module-path 和 -cp（或 --class-path）不是“可互换的两个选项”，而是两套不兼容的加载逻辑。放错位置，轻则类找不到，重则模块解析失败、NoClassDefFoundError 或 IllegalAccessError 静默出现。
关键判断只有一条：这个JAR里有没有 module-info.class？
- 有 → 必须走
--module-path，否则它会被当成普通JAR，“模块声明完全失效” - 没有 → 只能走
-cp；若硬塞进--module-path，JVM会把它当作“自动模块”（automatic module），名字默认是 JAR 文件名（如guava-31.1-jre.jar→ 模块名guava.31.1.jre），但包无封装、无requires约束，容易引发split package错误 - 混合项目（部分模块化、部分非模块化）→ 两者必须同时存在，且不能交叉混用：模块路径里的东西，类路径里的代码默认看不到；反之亦然
运行时报 Module not found 或 Unable to derive module descriptor 怎么办？
这是模块路径配置最典型的报错，本质是 JVM 在 --module-path 下找到了 JAR，但无法识别其模块身份。
-
Unable to derive module descriptor：JAR 里没module-info.class，又没显式指定模块名（比如用--module-path lib/foo.jar --add-modules foo但没配--module-version或自动推导失败） -
Module not found: xxx：你写了requires xxx;，但xxx没出现在--module-path中；注意，它不会从-cp里找 - 常见漏点：忘了把
java.base以外的平台模块（如java.logging）也加到--add-modules，尤其在自定义最小运行镜像时
实操建议：用 jar -f your-module.jar | grep module-info 确认是否存在；再用 java --list-modules | grep xxx 看目标模块是否已加载。
立即学习“Java免费学习笔记（深入）”；
为什么 -cp 里放了模块化 JAR，Class.forName("xxx.Yyy") 却能成功？
因为类路径加载器（AppClassLoader）根本不管 module-info.class —— 它只按传统方式扫描 .class 文件。所以即使你把 spring-core-6.2.0.jar（含 module-info.class）扔进 -cp，Class.forName 仍能加载其中任意 public 类，但所有模块语义（exports、opens、requires）全部失效。
- 后果是：你无法用
ModuleLayer控制模块图，反射访问受限包会抛IllegalAccessException，JPMS 的强封装形同虚设 - 更隐蔽的问题：如果同一类在
-cp和--module-path中都存在（比如两个版本的commons-lang3），--module-path优先，-cp的那个被彻底忽略——但编译期可能还引用着旧版 API
IDE（如 Eclipse/IntelliJ）里勾选 “Add to Modulepath” 就万事大吉了？
不。IDE 的图形化操作只是帮你生成启动参数，真正起作用的是最终传给 JVM 的命令行。很多 IDE 默认仍以类路径模式运行，尤其当你没写 module-info.java 或项目 SDK 设为 Java 8 时，Modulepath 标签页甚至不会显示。
- Eclipse：右键项目 → Build Path → Configure Build Path → Libraries → Add External JARs → 默认加到
Classpath；要加到模块路径，得手动切换到Modulepath选项卡（仅当项目启用了模块支持才可见） - IntelliJ：Project Structure → Modules → Dependencies → Scope 列选择
Runtime不代表就是模块路径；必须勾选Use module path并确保module-info.java存在且无语法错误 - 最容易被忽略的一点：Maven 构建时，
maven-compiler-plugin需显式配置<release>11</release>或<source>11</source>，否则javac不会处理module-info.java
模块系统不是开关，而是一套需要贯穿编译、打包、运行三阶段的契约。少一个环节对齐，就可能在生产环境突然崩出 ClassNotFoundException —— 而且往往发生在你没测过的冷路径上。
