本文详解在 java 9+ 模块系统下，如何正确编译位于类路径（classpath）中的非模块化源代码，并使其能访问位于模块路径（module-path）上的已编译模块（如 exploded modules），重点解决 `package is not visible` 和 `no source files` 等常见编译错误。
在 Java 平台模块系统（JPMS）中，非模块化代码（即传统 JAR 或目录结构的 classpath 代码）默认运行在未命名模块（unnamed module）中。该模块可自动读取所有系统模块（如 java.base），但不会自动读取模块路径（-p / --module-path）上用户提供的模块——即使这些模块已通过 -p 指定。这是导致 package com.myuser.hello is not visible 错误的根本原因：编译器虽知道模块存在，但未将它们加入当前编译上下文的模块图（module graph），因此未命名模块无法对其包进行访问。
正确的编译命令需显式将用户模块纳入模块图。关键参数是 --add-modules：
javac -p simple-modules -d output --add-modules ALL-MODULE-PATH \ classpath_entry/com/myuser/modules/main/MainApp.java
其中：
- -p simple-modules：指定包含 module1/ 和 module2/（含 module-info.class）的目录，作为模块路径；
- --add-modules ALL-MODULE-PATH：强制将模块路径中所有可解析的模块（即含有效 module-info.class 的目录或 JAR）添加到编译期模块图，使未命名模块能读取其导出的包；
- -d output：指定输出目录；
- 最后列出 .java 源文件路径（注意：-cp 用于运行时类路径，编译时不能用 -cp 指定源码目录——这正是 error: no source files 的根源；源文件必须显式列出或使用通配符如 normal-java-packages/**/*.java）。
✅ 补充建议与最佳实践：
立即学习“Java免费学习笔记（深入）”；
- 若仅需添加特定模块（更安全可控），可替换为：
--add-modules module1,module2（模块名需与 module-info.java 中 module xxx { ... } 一致）； - 编译整个源码目录时，推荐使用通配符（JDK 11+ 支持）：
javac -p simple-modules -d output --add-modules ALL-MODULE-PATH \ normal-java-packages/**/*.java
- 避免混淆：-cp（类路径）仅影响运行时或注解处理器路径，不参与模块解析；模块依赖必须通过 -p + --add-modules 协同声明；
- 验证模块是否被正确识别：添加 -Xdiags:verbose 可查看模块图构建详情；
- 注意 ALL-MODULE-PATH 不包含系统模块（它们始终可用），也不会自动开启 --add-reads 或 --add-exports——若模块未导出对应包（exports com.myuser.hello;），仍会报错，此时需检查 module-info.java 的导出声明。
总结：JPMS 中“非模块调用模块”的核心约束在于模块图可见性，而非路径可达性。-p 告诉 JVM “模块在哪”，而 --add-modules 才真正回答 “哪些模块应被当前编译单元所信任和使用”。理解这一分离设计，是驾驭混合模块环境的关键。
