Java 9的模块化系统(Jigsaw)怎么用_module-info.java配置指南

顺亿

2026-09-17 • 👁 0人浏览过

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 实体字段访问）。两者语义不同，不能互相替代。 Eclipse导入Android或其他的JAVA项目的正确方法 WORD版本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看下载例如：

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

对核心模块的开放，若旧代码强依赖反射（如某些测试工具），需显式加参数，否则启动就失败模块系统不是“加个文件就能跑”，它把依赖边界、封装粒度、启动方式全绑在一起 —— 少一个环节对不上，整个链路就断在看不见的地方。

相关文章