module-info.java必须置于src/main/java根目录下，与包目录平级；requires需显式声明transitive传递依赖；exports控制类可见性，opens专用于反射；模块化应用须用--module-path启动，禁用-classpath。
module-info.java 文件必须放在模块根目录下
Java 9+ 的模块系统不会自动扫描包结构来推断模块，module-info.java 必须是模块源码树的最顶层文件（即与 src/main/java 下第一个包同级），否则编译器直接报错：error: module not found 或 error: module-info.java must be the first file in the module。
常见错误：把 module-info.java 放在 src/main/java/com/example/ 里，或和 .gitignore 并列但不在 src/main/java 目录下。Maven 项目中，它应位于 src/main/java/module-info.java —— 和任何 package 目录平级。
- IDE（如 IntelliJ）可能默认创建在错误位置，需手动拖到正确路径
- Gradle 构建时若用
sourceSets.main.java.srcDirs = ["src/main/java"]，确保该路径下真有module-info.java - 如果模块只含资源（无 Java 类），仍需存在
module-info.java，否则不被视为命名模块
requires 语句不能省略 transitive 依赖传递性
当你声明 requires java.sql;，只是让当前模块能访问 java.sql 包；但如果 A 模块 requires B，而 B 又用到了 java.xml，A 默认**看不到** java.xml 中的类 —— 即使 B 已经 requires java.xml。
只有加了 transitive，B 的依赖才对 A “可见”：
立即学习“Java免费学习笔记（深入）”；
module com.example.app {
requires transitive com.example.data; // A 能用 data 模块的 public 类，也能用 data 所 requires 的模块（如 java.sql）
requires java.logging;
}- 漏写
transitive是运行时NoClassDefFoundError的高频原因，尤其在使用 Spring、Hibernate 等多层依赖框架时 -
requires static表示仅编译期需要（如注解处理器），运行时不强制加载，但也不能解决跨模块类型可见性问题 - JDK 自带模块如
java.desktop不支持transitive修饰（语法错误），因为它们本身不导出“可被传递”的依赖关系
exports 和 opens 的区别直接影响反射和序列化
exports 控制编译期和运行时的 **public 类可见性**；opens 则专为 **反射开放包路径**（比如 JSON 库反序列化、JPA 实体字段访问）。两者语义不同，不能互相替代。
例如：
module com.example.model {
exports com.example.model; // 其他模块可 new Model()、调用 public 方法
opens com.example.model to com.fasterxml.jackson.databind; // 仅允许 jackson 在运行时反射读写该包内字段
}- 只
exports不opens：Jackson 会抛IllegalAccessException（即使字段是 public） - 只
opens不exports：其他模块无法直接 import 该包，但反射可用 —— 适合内部 DTO + 外部序列化场景 -
opens后面必须跟具体模块名（或to列表），不能写opens com.example.model;（这是“开放给所有模块”，破坏封装，且 JDK 17+ 默认禁止）
模块路径启动失败常见于 classpath 混用
一旦用了 module-info.java，程序必须用 --module-path 启动，不能再靠 -cp 或 CLASSPATH 加载模块化 JAR。混用会导致 java.lang.module.FindException: Module xxx not found。
典型错误命令：
java -cp "lib/*" -m com.example.app/com.example.app.Main
正确写法：
java --module-path "mods;lib" -m com.example.app/com.example.app.Main
-
mods存放你自己的模块 JAR（含module-info.class），lib存放传统第三方 JAR（会被自动转为“自动模块”，名字来自 JAR 文件名） - 自动模块名含非法字符（如
guava-31.1-jre.jar→ 模块名guava.31.1.jre）会导致requires guava.31.1.jre;编译失败，得用requires guava;并配合--add-modules - JDK 16+ 默认禁用
--add-opens对核心模块的开放，若旧代码强依赖反射（如某些测试工具），需显式加参数，否则启动就失败
模块系统不是“加个文件就能跑”，它把依赖边界、封装粒度、启动方式全绑在一起 —— 少一个环节对不上，整个链路就断在看不见的地方。
