无法使用 javadoc 等命令?

本文详细指导如何从Oracle官网下载并安装JDK,重点讲解如何查看版本,以及为何初学者常忽视的环境变量配置。通过实例演示如何手动配置JAVA_HOME和Path,确保javac、java和javadoc命令正常工作。

安装 JDK

  谈到 Java 就离不开 JRE(Java Runtime Environment)JDK(Java Development Kit) 中包含了 JRE 和 JVM(Java Virtual Machine),所以我们一般直接安装 JDK,安装 JDK 首先肯定是去Oracle官网下载适合自己的开发版本,然后将 JDK 安装到自定义位置。

查看 JDK 版本

java -version   /*查看本机JDK版本*/

eg:

在这里插入图片描述

Java 常用命令

/*一些常用的java命令*/
javac 		/*编译*/
java     	/*执行*/
javadoc		/*生成java文档*/
···

eg:

在这里插入图片描述

出现问题

  javac 和 java 命令成功运行,但是 javadoc 命令则失败了,原因是没有配置环境变量。很多初学者就会出现这个问题,安装好 JDK 后发现根本用不着配置什么环境变量就可以开发和跑项目,所以就忽略了配置环境问题。那为什么不需要配置环境也可以使用呢?
我们到环境变量配置页看看,在安装了 JDK 的机器上就会看到 Path 的值中有如下路径。
在这里插入图片描述
  再到该路径下看看,会看到几个可执行文件,这说明新版 JDK 在安装的时候就自动为我们添加了环境配置,但是却只有四个,而 java 中的命令显然不止这四个,所以我们需要手动添加环境变量。(由此可以看出,命令其实就是一些可执行文件,而配置环境就是告诉计算机在哪里找到这些可执行文件)。
在这里插入图片描述
  手动配置就需要知道这些可执行文件的位置,那它们在哪呢?就在安装 JDK 目录下的 bin 目录中。如下图,其中包含了 java 的命令,旧版本除了 bin 下,jre/bin 目录下也有,所以安装旧版本 JDK 需要配置两个环境变量。
在这里插入图片描述

配置环境变量

  1. 打开系统->高级系统设置->环境变量。
    在这里插入图片描述
  2. 新建名为 JAVA_HOME 的变量,变量值为安装 JDK 的目录,这一步有两个原因:第一是为了某些软件识别,所以变量名必须为JAVA_HOME;第二是为了在 Path 中引用该目录。
    在这里插入图片描述
  3. 点击 Path 后开始配置环境变量,然后确认即可。
    在这里插入图片描述
  4. 测试 javadoc 命令,成功执行。
    在这里插入图片描述
在CMD中使用JavaDoc命令主要是为了根据Java代码中的文档注释生成HTML格式的文档。以下是详细教程: ### 1. 了解Java文档注释 Java中有三种注释方式,前两种`//`和`/* */`主要用于代码注释以提高可读性,而用于生成文档的是文档注释,它以`/**`开始,以`*/`结束。文档注释允许在程序中嵌入关于程序的信息,可使用javadoc工具软件将这些信息生成并输出到HTML文件中 [^1]。 例如: ```java /** * 这是一个类的文档注释 * 描述类的功能和用途 */ public class Doc { String name; /** * 这是一个方法的文档注释 * @author kuangsheng * @param name 传入的参数 * @return 返回传入的参数 * @throws Exception 可能抛出的异常 */ public String test(String name) throws Exception { return name; } } ``` ### 2. 编写包含文档注释的Java代码 将上述包含文档注释的Java代码保存为`.java`文件,例如`Doc.java`。 ### 3. 打开CMD命令提示符 通过Windows系统的搜索功能找到“命令提示符”并打开,或者使用快捷键`Win + R`打开运行窗口,输入`cmd`后回车打开。 ### 4. 使用javadoc命令生成文档 在CMD中使用以下命令格式来生成文档: ```plaintext javadoc -d <输出目录> <包名或Java文件路径> -encoding utf-8 -charset utf-8 ``` - `-d`:指定生成的文档输出的目录。 - `<输出目录>`:是你希望将生成的HTML文档保存的位置,例如`D:\doc`。 - `<包名或Java文件路径>`:可以是包名,也可以是具体的Java文件路径,如果是单个文件可以直接写文件名。 - `-encoding utf-8`:指定源文件的编码格式为UTF - 8。 - `-charset utf-8`:指定生成的HTML文档的字符编码为UTF - 8。 例如,要为`org.springmorning.demo.javabase.annotation.meta`包下的Java文件生成文档,命令如下: ```plaintext javadoc -d D:\doc org.springmorning.demo.javabase.annotation.meta -encoding utf-8 -charset utf-8 ``` ### 5. 查看生成的文档 执行完上述命令后,在指定的输出目录(如`D:\doc`)中会生成一系列的HTML文件,打开其中的`index.html`文件,就可以查看生成的Java文档。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值