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

- JDK (Java Development Kit):Java 开发工具包,包含了编译(
javac.exe)和运行(java.exe)Java 程序所需的工具。 - JRE (Java Runtime Environment):Java 运行环境,包含了运行 Java 程序所必需的库和虚拟机,JDK 包含了 JRE。
- 环境变量:是操作系统用来指定操作系统运行环境的一些参数,我们配置它,就是告诉操作系统:“嘿,当你需要用到
java或javac这些命令时,请去我指定的路径下找它们”。
第一步:下载并安装 JDK
如果你还没有安装 JDK,请先完成这一步。
- 访问官网:打开浏览器,访问 Oracle 官方 Java 下载页面:https://www.oracle.com/java/technologies/downloads/
- 选择版本:选择一个 LTS (长期支持) 版本,Java 17 或 Java 21,对于大多数用户来说,LTS 版本是最佳选择。
- 下载安装包:根据你的 Windows 10 系统是 64 位还是 32 位,选择对应的安装包,现在绝大多数电脑都是 64 位(x64)。
- 安装 JDK:双击下载的
.msi安装文件,然后按照提示进行安装。建议使用默认安装路径,C:\Program Files\Java\jdk-17,记住这个路径,后面会用到。
第二步:配置环境变量
这是整个过程的核心,我们将设置三个环境变量:JAVA_HOME、Path 和 CLASSPATH。
找到你的 JDK 安装路径
在配置之前,先确认一下你的 JDK 安装在哪里。
- 方法一(推荐):在开始菜单的搜索框中输入 “
cmd”,然后右键点击 “命令提示符”,选择 “以管理员身份运行”。 - 方法二:直接在文件资源管理器中导航到
C:\Program Files\Java目录,你会看到一个类似jdk-17的文件夹,这就是你的 JDK 根目录。
我的路径是:C:\Program Files\Java\jdk-17.0.2

打开 “编辑系统环境变量” 窗口
- 在 Windows 10 搜索框中输入 “
查看高级系统设置”,然后打开它。 - 或者,右键点击 “此电脑” -> “属性” -> “高级系统设置”。
- 在弹出的 “系统属性” 窗口中,点击右下角的 “环境变量...” 按钮。
配置 JAVA_HOME 变量
JAVA_HOME 是一个自定义变量,用来指明 JDK 的安装目录,很多 Java 中间件(如 Tomcat)都会依赖它。
- 在 “系统变量” 区域,点击 “新建...” 按钮。
- 变量名:输入
JAVA_HOME(全部大写)。 - 变量值:输入你刚才找到的 JDK 的根目录路径。注意不要包含末尾的
\bin。C:\Program Files\Java\jdk-17.0.2
- 点击 “确定”。
配置 Path 变量
Path 变量是系统命令的搜索路径,我们需要在这里添加 JDK 的 bin 目录,这样在任何地方都能使用 java 和 javac 命令。
- 在 “系统变量” 区域,找到并选中名为
Path的变量,然后点击 “编辑...” 按钮。 - 在弹出的编辑窗口中,点击 “新建”。
- 添加 JDK 的
bin目录:- 点击 “新建”,然后输入
%JAVA_HOME%\bin。 - 为什么用
%JAVA_HOME%? 因为这样引用了JAVA_HOME变量的值,未来如果你想更换 JDK 版本,只需修改JAVA_HOME的值即可,无需再修改Path,非常方便。
- 点击 “新建”,然后输入
- (可选但推荐)添加 JRE 的
bin目录:- 再次点击 “新建”,输入
%JAVA_HOME%\jre\bin,这可以确保一些依赖 JRE 的工具也能被找到。
- 再次点击 “新建”,输入
- 调整顺序:确保你新添加的两行 (
%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin) 位于列表的上方,这样系统会优先在这些路径中查找命令,避免与其他版本的 Java 冲突。 - 点击 “确定” 保存所有修改。
配置 CLASSPATH 变量
CLASSPATH 指定了 Java 虚拟机在运行时查找 .class 文件(即类文件)的路径,对于 Java 8 及以上版本,如果不配置 CLASSPATH,系统也能正常工作,因为默认的 (当前目录) 已经被包含,但为了规范和兼容旧代码,我们还是配置一下。
- 再次点击 “新建...” 按钮。
- 变量名:输入
CLASSPATH(全部大写)。 - 变量值:输入
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar- :代表当前目录,非常重要,让 JVM 能首先在当前目录下查找类。
- :是路径分隔符,用来分隔不同的路径。
%JAVA_HOME%\lib\dt.jar和%JAVA_HOME%\lib\tools.jar:是 Java 核心类库所在的路径。
- 点击 “确定”。
第三步:验证配置
所有变量都配置好后,我们来验证一下是否成功。

-
重新打开命令提示符:必须重新打开,否则它仍然使用的是旧的变量环境,可以在开始菜单搜索
cmd并打开。 -
输入验证命令:
-
检查 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) -
检查编译器版本:
javac -version
如果成功,会显示
javac的版本号,应该和java的版本号一致。 -
检查环境变量是否生效:
echo %JAVA_HOME%
如果成功,会输出你在
JAVA_HOME中设置的路径。
-
常见问题与解决方法
-
问题1:
'java'不是内部或外部命令,也不是可运行的程序或批处理文件。- 原因:
Path变量配置错误或未生效。 - 解决:检查
Path变量中是否正确添加了%JAVA_HOME%\bin,并确保其位置靠前,然后完全关闭所有命令行窗口,重新打开一个再试。
- 原因:
-
问题2:
java -version和javac -version版本不一致。- 原因:系统中可能安装了多个版本的 JDK,
Path变量中的路径顺序导致找到了错误的版本。 - 解决:检查
Path变量,确保你想要使用的 JDK 的bin目录在最前面,或者,你可以使用where java和where javac命令来查看系统当前找到的java.exe和javac.exe文件路径。
- 原因:系统中可能安装了多个版本的 JDK,
-
问题3:配置了
JAVA_HOME但echo %JAVA_HOME%没有输出。- 原因:可能是拼写错误,或者变量名大小写不正确(
JAVA_HOME必须全大写)。 - 解决:仔细检查变量名和变量值是否输入正确。
- 原因:可能是拼写错误,或者变量名大小写不正确(
恭喜你!至此,你已经成功在 Windows 10 上配置好了 Java 开发环境,现在你可以开始编写和运行 Java 程序了。
