1 入门与环境配置

Java 部分的笔记，我个人感觉写得比较清楚，以至于有些啰嗦。主要适合知识巩固。

Java 开发包工具¶

Java 开发包工具(Java Development Kit, JDK)，包含软件库、基于命令行的编译器、解释器以及其它工具。如 javac（编译Java程序）、java（运行Java程序）、jdb（调试Java程序）。下载之后，即使没有 IDE 也能够运行 Java 程序。
在官方网站下载 Windows 的 jdk-21 后，其目录如下图所示：

我们在/bin目录下搜索 “java”，结果如下：

其中的 java.exe 和 javac.exe 分别就是用于运行、编译 Java 程序的可执行程序。

Java 程序的编写与运行¶

Java 程序的编写¶

在 JDK 下载了之后，其实不用 IDE 也能够编写和运行 Java 程序。比如，我在桌面创建了一个Test文件夹，文件夹下包含一个javacode的子文件夹。子文件夹中直接用记事本在Test.txt中编写如下代码：

Test/javacode/Test.txt
package javacode;

public class Test{
    public static void main(String[] args){
        System.out.println("HelloWorld!");
    }
}

由于我们只写了一个公共类，按照 Java 的规定，类名必须和文件名一致，都叫Test。更改后缀名为.java，如下图所示：

我的机器上装有 IDEA 集成开发环境，所以修改后缀之后显示了 IDEA 的图标。IDEA 是一款非常好的 Java IDE，用它编写代码可读性更强，手感也更舒适。比如下面我写的屎山代码：

观感舒适。

这是我自己写的一个贪吃蛇小游戏，游戏的逻辑和玩法都写得很一般，欢迎尝试。

Java 程序的运行¶

其实在 IDEA 中编写好代码之后，就可以直接点击运行了。当你点击运行的时候，实际上 IDEA 先给编译了一遍，生成的字节码在对应的/bin或者/out目录下（当然你也可以自己设置目录）。如果没有 IDEA，也可以使用 JDK 工具编译、运行 Java 源码。
比如上面的Test.java文件，我们现在要调用 javac.exe 编译这个 Java 源文件。假设我上面下载的 jdk-21 的绝对路径是D:/software/Java/jdk-21，那么可以在命令提示符中进行环境变量设置：

set JAVA_HOME = D:/software/Java/jdk-21
set path = %path%;%JAVA_HOME%/bin

这样，在任意命令行调用 javac.exe，系统都知道要从path路径寻找它；并且之后运行时系统也会在该路径下寻找 java.exe。在环境变量设置完成后，可以在 javacode 目录（.java文件所在的目录）下运行命令提示符，敲入命令javac Test.java，运行结果如下：

如果我们不在与 javacode 同级的目录，即 Test 下，也是可以运行的。比如返回到桌面，也可以通过-classpath添加路径：

java -classpath Test javacode.Test

运行结果如下。

如果源码被打包成了 .jar 包，jar 包本身也应该属于路径。比如这里有一个打包好了的包SnakeGame.jar，它的内部是这样的：

其中公共类Game的完全限定名为javacode.Game，我们直接在SnakeGame.jar所在目录的命令行下敲下面的命令：

java -classpath SnakeGame.jar javacode.Game

即可成功运行。

生成 Java API 注释文档¶

Java 特有的注释以及注释文档¶

ava 内有三类注释，单行注释//...和多行注释/*...*/沿用 C 语言的。另一种注释是/**...*/，这种注释可以加在一个类之前、一个方法之前或者一个变量之前，用于对其进行解释。

上面的注释经过生成得到注释文档，可以看到我们注释的内容。

可以看到注释文档是一个精美的html网页文件，并且含有我们在编译器中所编写的所有注释。

IDEA生成注释文档的方法¶

IDEA 会在设定的位置生成一堆文件，其中的 index.html 就是根注释文档。