在 javadoc 中使用源路径

Question

我想为名为 abc.java 的 java 文件创建 javadoc 源码放在

C:/project1/src/ 

.它使用包com.mypack所以类文件放在

C:/project1/src/com/mypack/.

现在，当我想生成 javadoc 时，我从 project1 目录运行命令

javadoc -d ./src -sourcepath ./src

它显示没有指定包或类

当我跑步时

javadoc -d ./src -sourcepath ./src com.mypack

它显示没有包com.mypack的源文件

我知道 sourcepath 用于给出 sourcefile 的放置位置，所以它应该给出正确的结果 src 仅作为 sourcepath 但它不为什么？？？

但是当我将 abc.java 移动到 project1/src/com/mypack 目录并现在将源路径指定为

javadoc -d ./src -sourcepath ./src com.mypack

然后它会生成javadoc，所以你能清除这个疑问，javadoc中何时以及如何使用sourcepath？

Answer 1

所有 Java 工具（javac、javadoc、IDE 等）都希望 Java 源文件和类文件存储在与包结构完全匹配的目录结构中。因此，如果您的类在包com.mypack 中，那么.java 源文件应该在src/com/mypack 中。不在src。

您也不应该将 .class 文件存储在 src 目录（用于存放源文件）中。使用javac -d ./classes（例如）使编译器将.class 文件存储在类目录中。并且 javac 会自动将您的 .class 文件放在 classes/com/mypack 下，以尊重包结构。

对 javadoc 也一样：不要将文档存储在 src 目录中（用于存放源文件）。使用 javadoc -d ./doc 使 javadoc 将文档存储在 doc 目录中。

一旦您对这些约定和工具感到满意，我建议您使用真正的构建工具（如 gradle 或 Maven，尽管我更喜欢 gradle），并采用他们的项目布局约定（他们使用相同的）。