Javadoc 是一个由 Java 语言编写的工具，用于从 Java 代码中提取注释并生成 HTML 格式的文档。以下是使用 Javadoc 工具生成文档的一般步骤：
-
编写代码并添加注释。在你的 Java 代码中添加注释是生成文档的关键。Javadoc 工具会读取这些注释，并将它们转换成 HTML 文档。
-
打开命令行或终端窗口。
- 如果你正在使用 Windows 操作系统，请点击 “开始” 菜单，然后在搜索框中输入 “cmd” 并按 Enter。
- 如果你正在使用 macOS 或 Linux 操作系统，请打开终端应用程序。
-
使用 “cd” 命令进入包含 Java 代码的目录。例如，如果代码在名为 “myproject” 的目录中，则可以输入以下命令：
cd /path/to/myproject
-
运行 Javadoc 工具。使用以下命令运行 Javadoc 工具：
javadoc [options] [packagenames] [sourcefiles] [@files]
-
[options]：是一些可选参数，例如 -d 指定文档输出目录，-author 包含作者信息，-version 包含版本信息等。
-
[packagenames]：是要包含在文档中的包名称。可以指定多个包名称，用空格分隔。如果不指定包名称，则默认包含所有包。
-
[sourcefiles]：是要包含在文档中的源代码文件名称。可以指定多个源代码文件名称，用空格分隔。如果不指定源代码文件名称，则默认包含所有源代码文件。
-
[@files]：是一个以 “@” 开头的文件列表。每个文件包含一行命令行参数。
例如，要生成一个名为 “MyProject” 的 Java 项目的文档，可以使用以下命令：
javadoc -d docs -author -version -classpath bin -sourcepath src com.example.myproject MyProject.java
其中，
-
-d docs：指定文档输出目录为 “docs” 目录。
-
-author：包含作者信息。
-
-version：包含版本信息。
-
-classpath bin：指定类路径为 “bin” 目录，其中包含编译后的类文件。
-
-sourcepath src：指定源代码路径为 “src” 目录，其中包含源代码文件。
-
com.example.myproject：指定要包含在文档中的包名称为 “com.example.myproject”。
运行完上述命令后，Javadoc 工具会在指定的文档输出目录中生成 HTML 格式的文档。你可以在浏览器中打开这些文档，查看生成的文档内容。
