如何在 Windows 10 上运行 javadoc？

Question

新手上路。我刚刚下载了Java JDK，从http://www.oracle.com/technetwork/java/javase/downloads/index.html下载并安装了左边的大按钮。Java正在运行，我已经从命令行运行它。我想在不输入完整路径名的情况下运行javadoc。但是，即使我这样做，可能是因为c:\Program Files\java....中有一个空格，Windows也无法找到它。我该如何只使用命令行运行javadoc？此外，在命令行中为什么Java可以运行而javadoc不能？它们都在同一个目录中。

命令行中的Windows错误消息：

javadoc /? 'javadoc' 不是内部或外部命令，也不是可运行的程序或批处理文件。

更新：Geany（一种轻量级Java编辑器）也找不到javac。这可能与上述问题有关。

- VannyJ

Answer 1

Java安装程序将目录"c:\Program Files\Common Files\Oracle\Java\javapath"添加到PATH环境变量中。该目录包含四个可执行文件：java.exe、javaw.exe、javac.exe和jshell.exe。Java开发工具包的其他工具位于不同的目录中，例如"c:\Program Files\Java\jdk-17\bin"。您可以提供完整路径"c:\Program Files\Java\jdk-17\bin\javadoc"，或者将该目录添加到PATH环境变量中。

- cayhorstmann

Answer 2

问：您是否考虑过使用像Eclipse、Netbeans或IntelliJ这样的集成开发环境？它们可以让您的工作更加高效-包括生成您的Javadoc。

问：或者，为您的每个项目创建一个构建文件（例如Ant build.xml），并包含一个“Javadoc”目标，这是另一种选择吗？

- paulsm4

Answer 3

Javadoc编译

要生成HTML文档，请在命令提示符中运行Javadoc，后跟要为其生成文档的源文件列表（即Javadoc [files]）。 Javadoc还提供了其他选项，可以在Javadoc命令后输入作为开关（即Javadoc [options] [files]）。 以下是一些基本的Javadoc选项：

-author - generated documentation will include a author section
-classpath [path] - specifies path to search for referenced .class files.
-classpathlist [path];[path];...;[path] - specifies a list locations (separated by ";") to search for referenced .class files.
-d [path] - specifies where generated documentation will be saved.
-private - generated documentation will include private fields and methods (only public and protected ones are included by default).
-sourcepath [path] - specifies path to search for .java files to generate documentation form.
-sourcepathlist [path];[path];...;[path] - specifies a list locations (separated by ";") to search for .java files to generate documentation form.
-version - generated documentation will include a version section

回答您的问题：

Javadoc [options] [files]
Javadoc java_file_name.java

确保您已经创建了一个JAVA_HOME系统变量，以使其正常工作。

- KiranGautam

---

是的，谢谢，确实是环境变量的问题，自从 XP 时代以来就没有再去调整过它们。 - VannyJ