为什么需要配置环境变量?
为了让你的电脑(操作系统)在任何位置都能找到并使用 Java 工具(如 javac, java, jar 等),而不是每次都进入到 Java 安装目录下执行。

这就像你告诉电脑:“嘿,以后所有关于 Java 的命令,都去 C:\Program Files\Java\jdk-17\bin 这个文件夹里找。”
第一步:准备工作 - 安装 JDK
在配置环境变量之前,你必须已经安装了 Java Development Kit (JDK),你可以从 Oracle 官网或 OpenJDK 官网下载并安装。
安装完成后,请确认你的 JDK 安装路径,通常是这样的:
- Oracle JDK:
C:\Program Files\Java\jdk-17.0.2 - Eclipse Temurin (OpenJDK):
C:\Program Files\Eclipse Adoptium\jdk-17.0.2.8-hotspot
为了方便后续操作,建议你把这个安装路径完整地复制下来。

第二步:配置环境变量(图文详解)
我们将配置三个关键的环境变量:
JAVA_HOME:JDK 的安装根目录。Path:系统可执行文件的搜索路径,我们在这里添加 JDK 的bin目录。CLASSPATH:Java 类的搜索路径(对于现代 Java 开发,此项已非必需,但了解它很重要)。
操作步骤:
-
打开“编辑系统环境变量”
- 在 Windows 搜索栏中输入
env,然后选择 “编辑系统环境变量”。 - 或者右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在 Windows 搜索栏中输入
-
配置
JAVA_HOME- 在“系统变量”区域,点击 “新建”。
- 变量名 输入:
JAVA_HOME - 变量值 输入你的 JDK 安装路径(注意:不要在末尾加反斜杠
\)。C:\Program Files\Java\jdk-17.0.2
- 点击“确定”保存。
-
配置
Path变量
(图片来源网络,侵删)- 在“系统变量”列表中,找到并选中名为
Path的变量,然后点击 “编辑”。 - 在弹出的编辑窗口中,点击 “新建”。
- 输入
%JAVA_HOME%,这个 符号表示引用前面已经定义好的JAVA_HOME变量的值,这样做的好处是,将来如果 JDK 升级,你只需要修改JAVA_HOME的值即可,Path无需改动。 - (可选但推荐)再新建一行,输入
%JAVA_HOME%\bin,这能确保bin目录也被明确包含。 - 重要提示:请确保
%JAVA_HOME%或%JAVA_HOME%\bin这一行在列表的上方,或者至少在其他 JDK 相关路径的上方,以防止系统找到错误的 Java 版本。 - 点击“确定”保存。
- 在“系统变量”列表中,找到并选中名为
-
配置
CLASSPATH(了解即可)- 对于 Java 8 及以上版本,日常开发通常不需要配置
CLASSPATH,JDK 会自动在当前目录和 JDK 的库中查找类文件。 - 如果你的项目有特殊需求,或者想了解它,可以像配置
JAVA_HOME一样新建一个系统变量。 - 变量名 输入:
CLASSPATH - 变量值 输入:
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar- 代表当前目录,非常重要!
- 是 Windows 下的路径分隔符。
- 后面两个是 JDK 自身的核心库文件路径。
- 如果不需要,可以跳过这一步。
- 对于 Java 8 及以上版本,日常开发通常不需要配置
-
保存所有设置
在所有窗口中,一路点击“确定”保存设置,直到关闭“系统属性”窗口。
第三步:验证配置
配置完成后,需要重新打开一个新的命令行窗口(CMD 或 PowerShell)来让环境变量生效,在已经打开的窗口中配置可能不会立即生效。
-
检查
JAVA_HOME- 在新窗口中输入:
echo %JAVA_HOME%
- 如果配置成功,会显示你设置的 JDK 路径,
C:\Program Files\Java\jdk-17.0.2。
- 在新窗口中输入:
-
检查 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 -version
- 如果配置成功,会显示编译器的版本,应与
java -version的版本一致。javac 17.0.2
- 输入以下命令:
如果以上三个命令都执行成功,并且输出了正确的版本信息,那么恭喜你,Java 环境变量已经成功配置!
常见问题与解决方案
问题:'java' 不是内部或外部命令,也不是可运行的程序或批处理文件。
- 原因:
Path变量没有配置正确,或者系统没有找到java.exe文件所在的bin目录。 - 解决方法:
- 仔细检查
Path变量,确保%JAVA_HOME%\bin或直接指向bin目录的路径存在且拼写正确。 - 确保你输入的是
java -version而不是Java -version(注意大小写)。 - 重启电脑,确保环境变量完全生效。
- 仔细检查
问题:javac 命令可用,但 java 命令不可用,或者反之。
- 原因:
Path变量中可能只添加了其中一个,或者你的系统安装了多个 JDK(如 JRE 和 JDK),导致Path路径混乱。 - 解决方法:
- 检查
Path变量,确保同时包含了java.exe和javac.exe所在的路径。 - 检查
Path变量的顺序,将你希望使用的 JDK 的bin目录放在最前面。 - 使用
where java和where javac命令来查看系统当前找到的是哪些java和javac程序。
- 检查
问题:如何管理多个 JDK 版本?
- 解决方案:手动修改
JAVA_HOME和Path比较麻烦,推荐使用专门的版本管理工具,如:- SDKMAN! (适用于 Windows, macOS, Linux)
- Jabba (适用于 macOS, Linux)
- Adoptium Temurin Installer (Eclipse 官方提供的安装器,可以方便地切换版本)
这些工具可以让你在命令行中轻松切换不同的 JDK 版本,而无需手动修改环境变量。
| 变量名 | 作用 | 示例值 | 备注 |
|---|---|---|---|
JAVA_HOME |
JDK 的根目录,方便其他程序引用 | C:\Program Files\Java\jdk-17.0.2 |
强烈建议配置,便于维护 |
Path |
系统命令搜索路径 | 添加 %JAVA_HOME%\bin |
必须配置,让系统找到 java, javac 等命令 |
CLASSPATH |
Java 类文件搜索路径 | .;%JAVA_HOME%\lib\dt.jar;... |
Java 8+ 后非必需,了解即可 |
希望这份详细的指南能帮助你成功配置 Java 环境!
