在 Windows 环境中手动安装 JDK，本质上就是完成两件事：第一，把 JDK 安装包解压到固定目录；第二，正确配置系统环境变量，让操作系统能够识别 java、javac 等命令，并让后续的开发工具链（IDEA、Maven、Gradle、Tomcat 等）能够定位到 JDK 的安装路径。
本文记录一次 JDK 21 的手动安装过程，以及在 Windows 中需要配置哪些环境变量、每个变量的作用、常见错误和验证方式。
一、JDK 安装目录说明
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会提示找不到命令 - IDEA / Eclipse / Maven / Gradle 等工具可能无法自动定位 JDK
- 多版本 JDK 共存时，系统会随机使用某个版本，造成版本冲突
因此，配置环境变量是手动安装 JDK 的关键步骤。
三、必须配置的环境变量
手动安装 JDK 21 时，最推荐、最标准的配置方式是：
- 配置
JAVA_HOME - 在
Path中加入%JAVA_HOME%\bin
这两项配置是工业界通用规范，也是各类工具链默认识别的规则。
四、配置 JAVA_HOME（核心变量）
1. JAVA_HOME 的作用
JAVA_HOME 用于指向 JDK 的根目录，是 Java 生态中最关键的环境变量之一。
大量工具默认依赖它，例如：
- Maven 会通过
JAVA_HOME查找 JDK - Gradle 会通过
JAVA_HOME查找 JDK - Tomcat 在启动脚本中常用
JAVA_HOME - Jenkins、Spring Boot、各种 CI/CD 脚本都会优先读取
JAVA_HOME
因此，配置 JAVA_HOME 基本属于必须步骤。
2. JAVA_HOME 的配置值
在 Windows 系统变量中新增变量：
变量名：
JAVA_HOME
变量值：
D:\environment\JDK\jdk-21.0.10
注意：这里必须填写 JDK 的根目录，而不是 bin 目录。错误写法例如：
D:\environment\JDK\jdk-21.0.10\bin
这种写法会导致后续工具无法正确识别 JDK。
