本文详解在 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）。
✅ 补充建议与最佳实践：
