Java官方文档，JDK官方文档

## 简介

作为程序员，看文档是必备技能，现在Java更新的这么快，你知道去哪看官方文档吗？

我整理了一个官方文档的网站：https://javadoc.oldmoon.top ，但其内容为英文，如果你想阅读英文文档，这个网站相信对你来说非常有用。

目前其中收集了以下JDK文档：
- JDK8-8u371
- JDK11-11.0.19
- JDK17-17.0.12
- JDK20-20.0.1
- JDK21-21.0.4
- JDK22-22.0.2

<!-- more -->

## 什么是JDK？

`Java Development Kit` (JDK) 是用于开发Java应用程序和小程序的软件开发环境。它由 `Oracle` 公司发布，包含了 `Java` 编程语言的核心工具和库。JDK的主要组件包括：

- Java编译器 (`javac`)：将Java源代码编译成字节码。
- Java运行时环境 (`JRE`)：包含Java虚拟机 (`JVM`) 和标准类库，用于运行Java程序。
- Java虚拟机 (`JVM`)：执行编译后的 `Java` 字节码，使 `Java` 程序能够在不同平台上运行。
- 开发工具：如调试器 (`jdb`)、文档生成器 (`javadoc`)、打包工具 (`jar`) 等123。

`JDK` 是 `Java` 开发的基础工具，开发者可以使用它编写、编译、调试和运行 `Java` 程序。

## 什么是Javadoc？

`Javadoc` 是由 `Sun Microsystems`（现为 `Oracle` 公司）创建的文档生成工具，用于生成 `Java API` 文档。它从 `Java` 源代码中的注释生成 `HTML` 格式的文档，使开发者能够方便地浏览和理解代码。

`Javadoc` 注释通常位于类、方法或字段的声明之前，使用特殊的注释格式：

```Java
/**
 * 这是一个类的示例。
 * @author 作者名
 * @version 版本号
 * @since 版本号
 */
public class ExampleClass {
    /**
     * 这是一个方法的示例。
     * @param 参数描述
     * @return 返回值描述
     * @throws 异常描述
     */
    public int exampleMethod(int param) {
        // 方法体
    }
}
```

按照 `Javadoc` 的规范编写代码注释后，使用 `Javadoc` 工具即可生成对应的API文档，生成的文档包括类的描述、方法的详细信息、参数和返回值的说明等。

## 如何下载JDK文档？

要下载JDK文档，你可以按照以下步骤进行：

1. 访问Oracle官方网站：打开浏览器，访问 Oracle Java SE文档页面。
2. 选择JDK版本：在页面中，你会看到不同版本的JDK文档。选择你需要的版本，例如JDK 8、JDK 11或JDK 17。
3. 下载文档：点击所选版本的“`Download Documentation`” 类似链接。这将带你到该版本的API文档页面。

下载后，解压整个文档的压缩包（通常为.zip格式），或者直接浏览文档即可。

> PS：官网下载的文档都是HTML文件，需要在浏览器环境下才能更好的阅读。

*如果你无法找到官网链接，还想要下载JDK文档的话，可以评论留下联系方式，老狗可以为你排忧解难。*