核心概念
在开始之前,我们先简单理解一下为什么需要配置环境变量。

- JDK (Java Development Kit):Java 开发工具包,包含了编译(
javac)和运行(java) Java 程序所需的工具。 - JRE (Java Runtime Environment):Java 运行时环境,用于运行已经编译好的 Java 程序,JDK 包含了 JRE。
- 环境变量:操作系统用来存储一些可被程序访问的配置信息的地方,我们配置 Java 环境变量,就是告诉操作系统:“嘿,当你需要找
java.exe或javac.exe这些工具时,去我指定的这个目录里找!”
第一步:下载并安装 JDK
如果还没有安装 JDK,请先完成这一步。
- 访问官网:打开浏览器,访问 Oracle 官方 Java 下载页面:https://www.oracle.com/java/technologies/downloads/
- 选择版本:选择一个长期支持版本,Java 17 或 Java 21,对于学习来说,这些版本非常稳定。
- 下载安装包:根据你的 Windows 10 系统是 64 位还是 32 位,下载对应的安装包,现在绝大多数电脑都是 64 位,文件名通常包含
x64。 - 安装 JDK:
- 双击下载的
.exe文件。 - 一路点击“下一步”即可完成安装。建议不要修改默认的安装路径,
C:\Program Files\Java\jdk-17,这能避免后续配置时出错。 - 安装完成后,可以关闭安装向导。
- 双击下载的
第二步:查找 JDK 安装路径
我们需要知道 JDK 具体安装在了哪里,才能在环境变量中正确地指向它。
- 打开文件资源管理器。
- 进入你安装 JDK 的目录,通常是
C:\Program Files\Java。 - 你会看到一个类似
jdk-17.0.x的文件夹(x是版本号),这就是 JDK 的主目录。 - 复制这个路径,我们稍后会用到。
C:\Program Files\Java\jdk-17.0.2。
第三步:配置环境变量
这是最关键的一步,我们需要配置三个环境变量:JAVA_HOME、Path。
通过图形界面配置(推荐新手)
-
打开“编辑系统环境变量”
(图片来源网络,侵删)- 在 Windows 搜索栏(任务栏上的放大镜图标)中输入 “编辑系统环境变量” 并打开它。
-
打开“环境变量”窗口
- 在弹出的“系统属性”窗口中,点击右下角的“环境变量...”按钮。
-
创建
JAVA_HOME变量- 在“系统变量”(注意不是“用户变量”)区域,点击“新建...”。
- 变量名:输入
JAVA_HOME(全大写,不能有空格)。 - 变量值:粘贴你刚才复制的 JDK 安装路径。
C:\Program Files\Java\jdk-17.0.2。 - 点击“确定”。
-
编辑
Path变量- 在“系统变量”列表中,找到并选中名为
Path的变量,然后点击“编辑...”。 - 在弹出的“编辑环境变量”窗口中,点击“新建”。
- 输入
%JAVA_HOME%\bin。- 重要提示:
%JAVA_HOME%是一个变量引用,它会自动替换成你之前设置的JAVA_HOME的值(即C:\Program Files\Java\jdk-17.0.2)。\bin是 JDK 中存放java.exe和javac.exe等核心工具的目录。
- 重要提示:
- 确保新添加的
%JAVA_HOME%\bin在列表的顶部,你可以通过“上移”按钮将其调整到最上面,这可以避免系统可能找到其他版本的 Java(比如旧版本或预装的其他软件自带的 Java)。 - 点击“确定”保存。
- 在“系统变量”列表中,找到并选中名为
-
完成所有窗口
(图片来源网络,侵删)- 依次点击所有窗口的“确定”或“应用”按钮,关闭所有对话框,配置完成!
第四步:验证配置
配置完成后,我们需要验证一下是否成功。
-
重启命令提示符或 PowerShell
- 非常重要! 你必须重新打开一个新的命令提示符 或 PowerShell 窗口,之前打开的窗口不会加载新的环境变量。
-
检查 Java 版本
- 在新的命令提示符窗口中,输入以下命令并按回车:
java -version
- 如果配置成功,你会看到类似下面这样的输出,显示你安装的 Java 版本信息:
java version "17.0.2" 2025-01-18 Java(TM) SE Runtime Environment (build 17.0.2+8-86) Java HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-86, mixed mode, sharing)
- 在新的命令提示符窗口中,输入以下命令并按回车:
-
检查 Java 编译器版本
- 输入以下命令检查编译器
javac是否也能被找到:javac -version
- 成功的话,会输出:
javac 17.0.2
- 输入以下命令检查编译器
-
检查
JAVA_HOME变量- 输入以下命令,检查
JAVA_HOME是否被正确设置:echo %JAVA_HOME%
- 如果配置成功,它会输出你设置的 JDK 路径:
C:\Program Files\Java\jdk-17.0.2
- 输入以下命令,检查
第五步:常见问题与解决
-
问题1:
'java' 不是内部或外部命令...- 原因:最常见的原因是
Path变量配置错误,或者没有重启命令提示符。 - 解决:
- 仔细检查
Path变量中是否正确添加了%JAVA_HOME%\bin。 - 确保
%JAVA_HOME%\bin在Path列表的最前面。 - 关闭所有命令提示符窗口,重新打开一个再次尝试。
- 仔细检查
- 原因:最常见的原因是
-
问题2:
echo %JAVA_HOME%输出为空- 原因:
JAVA_HOME变量没有被创建,或者创建在了“用户变量”而不是“系统变量”中。 - 解决:返回“编辑系统环境变量”窗口,检查
JAVA_HOME是否在“系统变量”列表中,如果不在,请按第三步重新创建。
- 原因:
-
问题3:版本不匹配或找到了错误的 Java
- 原因:系统中可能安装了多个版本的 Java,或者
Path中有其他指向旧 Java 的路径。 - 解决:编辑
Path变量,确保%JAVA_HOME%\bin位于列表的最顶部,并将其余可能指向旧 Java 的路径删除或注释掉(在路径前加 )。
- 原因:系统中可能安装了多个版本的 Java,或者
