本文记录了在 Windows 环境下手动安装 JDK 21 的完整流程。核心步骤包括将 JDK 解压至固定目录，并配置系统环境变量。重点说明了必须配置的 JAVA_HOME 和 Path 变量，解释了为何 JDK 21 不再需要配置 CLASSPATH。最后提供了通过 java -version、javac -version 及 where java 命令验证安装是否成功的常用方法，并排查了常见的环境变量冲突问题。
在 Windows 环境中手动安装 JDK，本质上就是完成两件事：第一，把 JDK 安装包解压到固定目录；第二，正确配置系统环境变量，让操作系统能够识别 java、javac 等命令，并让后续的开发工具链（IDEA、Maven、Gradle、Tomcat 等）能够定位到 JDK 的安装路径。
本文记录一次 JDK 21 的手动安装过程，以及在 Windows 中需要配置哪些环境变量、每个变量的作用、常见错误和验证方式。
JDK 已经下载并放置在如下路径：
D:\environment\JDK\jdk-21.0.10
该目录结构通常如下：
bin：核心可执行文件目录（java、javac、javadoc 等）lib：JDK 核心类库conf：JDK 配置文件目录include：JNI 相关头文件jmods：Java 模块系统文件（JDK 9+ 引入）后续所有环境变量配置都将基于这个目录。
如果仅仅把 JDK 解压到某个目录，但没有配置环境变量，那么：
java -version 会提示找不到命令因此，配置环境变量是手动安装 JDK 的关键步骤。
手动安装 JDK 21 时，最推荐、最标准的配置方式是：
JAVA_HOMEPath 中加入 %JAVA_HOME%\bin这两项配置是工业界通用规范，也是各类工具链默认识别的规则。
JAVA_HOME 用于指向 JDK 的根目录，是 Java 生态中最关键的环境变量之一。
大量工具默认依赖它，例如：
JAVA_HOME 查找 JDKJAVA_HOME 查找 JDKJAVA_HOMEJAVA_HOME因此，配置 JAVA_HOME 基本属于必须步骤。
在 Windows 系统变量中新增变量：
变量名：
JAVA_HOME
变量值：
D:\environment\JDK\jdk-21.0.10
注意：这里必须填写 JDK 的根目录，而不是 bin 目录。错误写法例如：
D:\environment\JDK\jdk-21.0.10\bin
这种写法会导致后续工具无法正确识别 JDK。
Path 是 Windows 用来搜索可执行程序的环境变量。
如果 Path 中包含了 Java 的 bin 目录，那么在任意位置打开 CMD 或 PowerShell，都可以直接执行：
javajavacjavadocjar否则每次执行命令都必须写完整路径，例如：
D:\environment\JDK\jdk-21.0.10\bin\java -version
这显然不适合日常开发。
进入系统变量中的 Path，新增一条：
%JAVA_HOME%\bin
这里推荐使用 %JAVA_HOME% 的写法，而不是直接写绝对路径，例如：
D:\environment\JDK\jdk-21.0.10\bin
原因在于：
JAVA_HOME%JAVA_HOME% 为标准写法在早期 Java 版本（尤其是 JDK 1.4、1.5、1.6 时代），很多教程会要求配置：
CLASSPATH=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
原因是当时 Java 编译器、运行时依赖一些 jar 包，需要通过 CLASSPATH 让 JVM 找到这些类库。
在 JDK 9 之后，Java 引入了模块化（JPMS），JDK 内部结构发生了较大变化，传统的：
dt.jartools.jar在 JDK 21 中已经不存在。
同时，在现代开发环境中：
因此，JDK 21 环境下，手动配置 CLASSPATH 不仅没有必要，反而可能引入错误，造成编译、运行路径冲突。
在 JDK 21 的手动安装中，CLASSPATH 不建议配置。
保持为空是最合理的选择。
在本次安装中，需要配置的环境变量如下。
JAVA_HOME = D:\environment\JDK\jdk-21.0.10
在 Path 中新增：
%JAVA_HOME%\bin
JDK 21 不需要配置 CLASSPATH，保持未配置即可。
环境变量配置完成后，必须重新打开命令行窗口，因为环境变量只会在新启动的进程中生效。
随后执行以下命令验证。
执行：
java -version
正常情况下会输出类似信息：
java version "21.0.10" 2025-xx-xx LTS Java(TM) SE Runtime Environment ... Java HotSpot(TM) 64-Bit Server VM ...
重点在于版本号必须匹配 21.0.10。
执行：
javac -version
正常输出类似：
javac 21.0.10
如果 java 能执行但 javac 不能执行，通常说明 Path 配置有误，或者指向的是 JRE 而非 JDK。
执行：
echo %JAVA_HOME%
如果输出：
D:\environment\JDK\jdk-21.0.10
则说明 JAVA_HOME 已正确生效。
执行：
where java
正常情况下应返回：
D:\environment\JDK\jdk-21.0.10\bin\java.exe
如果返回多个路径，说明系统中存在多个 Java 版本，且 Path 中可能存在重复或旧版本残留。
通常原因是：
%JAVA_HOME%\binJAVA_HOME 指向了错误目录处理方式：
%JAVA_HOME%\binecho %JAVA_HOME% 验证变量是否生效通常是系统里曾安装过旧版 Java，并且旧版本路径排在 Path 更靠前的位置。
排查方式：
where java 查看实际调用路径C:\Program Files\Java\jdk1.8.0_xxx\bin C:\Program Files (x86)\Common Files\Oracle\Java\javapath
尤其是：
C:\Program Files (x86)\Common Files\Oracle\Java\javapath
这是 Oracle Java 安装器常见的自动注入路径，容易覆盖手动配置的版本。
解决方式：
%JAVA_HOME%\bin 排在 Path 的更前面这种情况通常是：
解决方式依旧是检查 Path 和 JAVA_HOME。
在 Windows 上手动安装 JDK 21，真正必须配置的环境变量只有两项：
JAVA_HOME：指向 JDK 根目录Path：加入 %JAVA_HOME%\bin而 CLASSPATH 在 JDK 21 环境中不再需要配置，强行配置反而可能带来兼容性问题。
最终配置如下：
JAVA_HOME = D:\environment\JDK\jdk-21.0.10Path += %JAVA_HOME%\bin配置完成后，通过 java -version、javac -version、where java 可以快速验证是否安装成功。
这套配置也是目前最通用、最标准、最符合工程实践的 JDK 环境配置方式。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online