目录
- 第一步:下载并安装 JDK
- 1 检查系统是否已安装 Java
- 2 下载 JDK
- 3 安装 JDK
- 第二步:配置环境变量
- 1 找到 JDK 安装路径
- 2 打开“编辑系统环境变量”
- 3 配置
JAVA_HOME变量 - 4 编辑
Path变量
- 第三步:验证配置是否成功
- 1 打开命令提示符 (CMD)
- 2 执行验证命令
- 常见问题与解决方案
- Q1:
java或javac不是内部或外部命令... - Q2:
JAVA_HOME未被识别为内部或外部命令... - Q3: 如何配置多个 JDK 版本?
- Q1:
第一步:下载并安装 JDK
1 检查系统是否已安装 Java
在配置之前,最好先确认你的电脑上是否已经安装了 JDK,打开命令提示符(按 Win + R,输入 cmd,回车),然后输入以下命令:

java -version
- 如果显示了 Java 版本信息(
java version "1.8.0_321"),说明你的电脑上已经安装了 JDK,你可以跳到 3 步,记录下安装路径,然后直接进入 第二步:配置环境变量。 - 如果提示
'java' 不是内部或外部命令...,说明没有配置环境变量,或者 JDK 未安装,你需要继续下面的步骤。
2 下载 JDK
我们推荐使用 Oracle JDK 或 OpenJDK,对于初学者来说,Oracle JDK 是最常见和稳定的选择。
- 访问 Oracle 官方下载页面:Oracle Java SE Development Kit 下载
- 选择适用于 Windows 的 x64 Installer 下载,文件名通常以
.exe- 注意:下载可能需要登录 Oracle 账户,如果没有,可以免费注册一个。
3 安装 JDK
- 双击你下载的
.exe安装文件。 - 重要: 在安装过程中,务必记下 JDK 的安装路径,默认路径通常是
C:\Program Files\Java\jdk-<version>(C:\Program Files\Java\jdk-17.0.2),你可以选择默认路径,也可以自定义,但一定要记住它。 - 一路点击 "下一步" 即可完成安装,安装程序通常会自动帮你把 JDK 的
bin目录添加到系统Path中,但为了教学和清晰,我们将手动进行配置,这样能更好地理解整个过程。
第二步:配置环境变量
环境变量的作用是告诉操作系统,在哪里可以找到 Java 的可执行文件和库。
1 找到 JDK 安装路径
打开文件资源管理器,导航到你安装 JDK 的目录。
C:\Program Files\Java\jdk-17.0.2
你会看到两个主要文件夹:

bin:包含java.exe,javac.exe等可执行文件。lib:包含 Java 的类库文件。
我们需要将 bin 目录的路径添加到 Path 变量中,并创建一个新的变量 JAVA_HOME 来指向 JDK 的根目录。
2 打开“编辑系统环境变量”
- 在 Windows 搜索栏(任务栏上的放大镜图标)中搜索 “编辑系统环境变量” 并打开它。
- 在弹出的“系统属性”窗口中,点击右下角的 “环境变量...” 按钮。
3 配置 JAVA_HOME 变量
JAVA_HOME 是一个约定俗成的变量,很多 Java 相关的工具(如 Tomcat, Maven)都会使用它来寻找 JDK。
- 在“环境变量”窗口的 “系统变量” 部分(不是“用户变量”),点击 “新建...”。
- 变量名:输入
JAVA_HOME - 变量值:输入你刚才记录的 JDK 的根目录路径(不要包含末尾的反斜杠
\)。C:\Program Files\Java\jdk-17.0.2
- 点击 “确定”。
4 编辑 Path 变量
Path 变量是操作系统的搜索路径列表,当你在命令行输入一个命令时,系统会按顺序在 Path 中列出的所有目录里寻找对应的可执行文件。
- 在“系统变量”列表中,找到名为
Path的变量,选中它,然后点击 “编辑...”。 - 在“编辑环境变量”窗口中,你会看到一系列路径,点击 “新建”。
- 在新的一行中,输入
%JAVA_HOME%\bin。- 为什么用
%JAVA_HOME%\bin?%JAVA_HOME%是一个引用,它会自动被替换为你之前设置的JAVA_HOME变量的值。- 这种写法的好处是,如果你将来需要更换 JDK,你只需要修改
JAVA_HOME的值即可,无需再修改Path变量,非常方便。
- 为什么用
- (推荐) 为了确保兼容性,你还可以将原来的 Java 路径(如果存在)移动到这个新条目的下面,或者直接删除它,系统会从上到下搜索路径,所以把新的、规范的路径放在前面是最佳实践。
- 点击 “确定” 关闭所有窗口。
第三步:验证配置是否成功
配置完成后,你需要打开一个新的命令提示符窗口来验证配置是否生效。注意:必须关闭之前打开的 CMD 窗口并重新打开一个新的,因为环境变量的更改只在新的进程中生效。

1 打开命令提示符 (CMD)
按 Win + R,输入 cmd,然后回车。
2 执行验证命令
在命令提示符窗口中,依次输入以下三个命令,每输入一个命令后按回车。
-
验证
JAVA_HOME是否设置成功echo %JAVA_HOME%
- 预期输出:它会打印出你设置的 JDK 路径,
C:\Program Files\Java\jdk-17.0.2,如果输出为空或不正确,说明JAVA_HOME变量设置有误。
- 预期输出:它会打印出你设置的 JDK 路径,
-
验证 Java 编译器
javac -version
- 预期输出:它会显示 Java 编译器的版本,
javac 17.0.2,如果提示“不是内部或外部命令...”,说明Path变量配置错误。
- 预期输出:它会显示 Java 编译器的版本,
-
验证 Java 运行时
java -version
- 预期输出:它会显示 Java 运行时的版本,
java version "17.0.2" 2025-01-16,如果提示“不是内部或外部命令...”,说明Path变量配置错误。
- 预期输出:它会显示 Java 运行时的版本,
如果以上三个命令都输出了正确的版本信息,恭喜你!Java 环境变量配置已成功!
第四步:常见问题与解决方案
Q1: 'java' 不是内部或外部命令,也不是可运行的程序或批处理文件。
- 原因:系统在
Path变量中找不到java.exe文件。 - 解决方案:
- 检查
Path变量中是否正确添加了%JAVA_HOME%\bin。 - 确保你输入的是
java -version(注意java前面没有路径)。 - 关闭所有 CMD 窗口,重新打开一个再试。
- 检查
JAVA_HOME的值是否正确,并且指向了存在的 JDK 目录。
- 检查
Q2: 'JAVA_HOME' 未被识别为内部或外部命令...
- 原因:这个错误通常出现在某些批处理脚本或软件中,而不是标准的 CMD 命令,在 CMD 中直接
echo %JAVA_HOME%是有效的,如果你在其他软件(如开发工具)中遇到此错误,说明该软件无法读取JAVA_HOME变量。 - 解决方案:
- 确保
JAVA_HOME是在 “系统变量” 中创建的,而不是“用户变量”。 - 确保
JAVA_HOME的值没有拼写错误,并且路径是正确的。 - 重启电脑,有时这能解决一些环境变量加载问题。
- 确保
Q3: 如何配置多个 JDK 版本?
这是一个常见的需求,例如在开发不同项目时需要切换不同的 Java 版本。
- 安装多个 JDK:按照第一步,在你的电脑上安装多个不同版本的 JDK(JDK 8 和 JDK 17)。
- 配置
JAVA_HOME:在系统环境变量中,JAVA_HOME只能指向一个路径,你可以手动修改JAVA_HOME的值来切换版本。 - 使用工具自动化切换:手动修改很麻烦,强烈推荐使用专门的工具来管理多个 JDK 版本,
- SDKMAN! (Linux/macOS/WSL)
- jEnv (macOS/Linux)
- Windows 上可以使用 SDKMAN! for Windows 或 Corretto Manager 等工具,或者编写简单的批处理脚本来切换
JAVA_HOME。
希望这份详细的教程能帮助你顺利完成 Java 环境的配置!
