exports 是 JPMS 中控制包可见性的核心机制,需配合模块声明、requires 依赖及 public 访问修饰符才能生效;限定导出(exports ... to)最安全,普通导出(无 to)慎用,三者缺一不可。

在 Java 9+ 模块化系统(JPMS)中,exports 是控制包可见性的核心机制,但它不是“简单公开”——必须配合模块声明、依赖关系和访问修饰符才能生效。只写 exports com.example.api; 并不等于其他模块能直接用,关键在于“谁被允许访问”以及“访问什么”。
基础写法:导出包并指定目标模块(推荐)
最安全、最常用的方式是使用 限定导出(exports ... to),明确列出可访问该包的模块名:
-
exports com.example.api to com.consumer.app;→ 仅com.consumer.app模块能访问此包中的public类和成员 -
exports com.example.config to org.springframework.core, org.junit.jupiter.api;→ Spring 和 JUnit 可加载配置类,其他模块编译失败 - 多个模块用英文逗号分隔,不能有空格;模块名必须与对方
module-info.java中声明的名称完全一致
普通导出:广播式开放(慎用)
若写成 exports com.example.api;(无 to 子句),表示向所有要求该模块的其他模块开放:
- 任何模块只要在自己的
module-info.java中写了requires com.example.lib;,就能访问这个包 - 风险明显:测试模块、插件、甚至恶意模块都可能意外或故意依赖内部 API
- 不适用于敏感包(如含凭证、配置、底层实现逻辑的包)
必须同时满足的三个条件
仅写 exports 不够,跨模块访问需三者齐备:
立即学习“Java免费学习笔记(深入)”;
- 提供方模块:在
module-info.java中正确声明exports 包名 [to 模块列表]; - 消费方模块:在自己的
module-info.java中声明requires 提供方模块名; - 包内类型本身是
public的——exports不提升访问级别,private字段、包私有类、默认访问的嵌套类仍不可见
常见错误与验证方式
写错 exports 容易导致编译报错,典型提示包括:
-
package com.example.api is not visible→ 消费方没加requires,或提供方没exports,或to名单里不含当前模块 -
module not found: com.example.lib→ 模块名拼写错误,或未放在模块路径(--module-path)下 - 运行时报
NoClassDefFoundError或反射失败 → 忘了opens(反射场景)或类本身非public


















