教程概览
配置 Java 环境变量主要分为两大步:

- 下载并安装 JDK:获取 Java 开发工具包。
- 配置系统环境变量:告诉 Windows 去哪里找 Java。
第一步:下载并安装 JDK (Java Development Kit)
在配置环境变量之前,你必须先安装 JDK,JDK 包含了 Java 编译器、运行时环境 和核心类库。
-
访问 Oracle 官网
- 打开浏览器,访问 Oracle 官方 JDK 下载页面: https://www.oracle.com/java/technologies/downloads/
-
选择合适的 JDK 版本
- 页面会显示最新的 JDK 版本,对于初学者,推荐使用 LTS (Long-Term Support) 长期支持版,JDK 17 或 JDK 21,它们会更稳定,支持周期更长。
- 点击 "Download" 按钮。
-
接受许可协议
(图片来源网络,侵删)- 在下载列表中,找到适用于 Windows x64 Installer 的版本。
- 勾选 "I reviewed and accept the Oracle Technology Network License Agreement for Oracle Java SE"(我已审阅并接受 Oracle Java SE 的 OTN 许可协议),然后点击下载链接。
-
安装 JDK
- 下载完成后,双击运行安装文件(
jdk-17_windows-x64_bin.exe)。 - 重要提示:安装过程中,不要修改默认的安装路径,保持默认即可(通常是
C:\Program Files\Java\jdk-17),修改路径可能会导致后续配置环境变量时出错。 - 点击 "下一步" (Next) 直到安装完成。
- 下载完成后,双击运行安装文件(
第二步:配置系统环境变量
这一步是核心,目的是让命令提示符(CMD)或 PowerShell 能够识别 java, javac 等命令。
获取 JDK 的安装路径
在配置之前,你需要知道 JDK 的准确路径。
- 打开文件资源管理器,导航到
C:\Program Files\Java目录。 - 你会看到一个类似
jdk-17的文件夹,进入该文件夹。 - 复击地址栏,全选路径并复制,你的路径可能和下图略有不同,请以你自己的为准。
打开环境变量设置窗口
- 在 Windows 10 的搜索栏中输入
编辑系统环境变量,然后打开它。 - 在弹出的 "系统属性" 窗口中,点击右下角的
环境变量...按钮。
配置 JAVA_HOME 变量
JAVA_HOME 是一个变量,它指向 JDK 的安装根目录,很多 Java 应用程序(如 Tomcat、Maven)都依赖这个变量来找到 JDK。

- 在 "环境变量" 窗口中,找到 "系统变量" (System variables) 区域(不是用户变量)。
- 点击
新建...(New...) 按钮。 - 变量名:输入
JAVA_HOME - 变量值:粘贴你在第一步中复制的 JDK 路径。
C:\Program Files\Java\jdk-17
- 点击
确定(OK) 保存。
配置 Path 变量
Path 变量是 Windows 的系统路径列表,它告诉操作系统在哪些目录中查找可执行文件,我们需要把 JDK 的 bin 目录添加到 Path 中。
-
在 "系统变量" 区域,找到名为
Path的变量,选中它,然后点击编辑...(Edit...) 按钮。 -
方法一(推荐):新建条目
- 在弹出的编辑窗口中,点击
新建(New)。 - 在新行中,粘贴
%JAVA_HOME%\bin。 - 为什么用
%JAVA_HOME%\bin? 因为它引用了我们刚刚创建的JAVA_HOME变量,如果将来需要更换 JDK 版本,你只需要修改JAVA_HOME的值即可,无需再修改Path,非常方便。
- 在弹出的编辑窗口中,点击
-
方法二(传统):追加到现有条目
- 滚动到列表的末尾,选中一个已有的条目(
C:\Windows\System32),然后点击编辑。 - 在该条目的末尾,输入一个英文分号 作为分隔符,然后粘贴你的 JDK
bin目录路径,;C:\Program Files\Java\jdk-17\bin。 - 注意:不推荐此方法,因为它不够灵活,且容易出错。
- 滚动到列表的末尾,选中一个已有的条目(
-
确保新添加的
bin路径在列表的顶部或靠前的位置,你可以通过点击上移(Move Up) 按钮来调整顺序。 -
依次点击
确定(OK) 关闭所有打开的窗口。
第三步:验证配置是否成功
所有配置都已完成,现在需要验证一下是否生效。
-
重新打开命令提示符
- 重要! 你必须关闭所有已打开的命令提示符 或 PowerShell 窗口,然后重新打开一个新的,因为旧窗口的环境变量在启动时已经加载,不会感知到新的更改。
-
输入验证命令
- 在新的命令提示符窗口中,依次输入以下两个命令,每输入一个按一次回车。
java -version
- 如果配置成功,你会看到类似下面的输出,显示你安装的 Java 版本信息。
java version "17.0.10" 2025-01-16 Java(TM) SE Runtime Environment (build 17.0.10+11-LTS-240) Java HotSpot(TM) 64-Bit Server VM (build 17.0.10+11-LTS-240, mixed mode, sharing)
-
测试编译器
- 接着输入第二个命令:
javac -version
- 如果配置成功,你会看到 Java 编译器的版本信息,通常和
java -version的版本一致。
javac 17.0.10
如果两个命令都成功显示了版本号,那么恭喜你,Java 环境变量配置已经全部完成!
常见问题与解决方案
-
问题:
'java' 不是内部或外部命令...- 原因:最常见的原因是
Path变量配置错误,或者没有重启命令提示符。 - 解决:
- 仔细检查
Path变量中是否正确添加了bin目录。 - 确保使用了
%JAVA_HOME%\bin而不是绝对路径,或者绝对路径是否正确。 - 关闭所有 CMD 窗口,重新打开一个再试。
- 仔细检查
- 原因:最常见的原因是
-
问题:
'javac' 不是内部或外部命令...- 原因:通常和
java命令报错的原因相同,说明Path中的bin目录没有被正确添加。 - 解决:参照上述
java命令报错的解决方案。
- 原因:通常和
-
问题:
JAVA_HOME变量拼写错误或未定义。- 原因:在配置
Path时,使用了%JAVA_HOME%\bin,但JAVA_HOME变量本身没有创建或拼写错误。 - 解决:回到
环境变量设置,检查系统变量中是否存在JAVA_HOME,并确保其值正确。
- 原因:在配置
配置 Java 环境变量是 Java 开发的第一步,虽然步骤稍多,但只要按照以下流程操作,就会非常顺利:
- 安装 JDK:使用默认路径安装。
- 设置
JAVA_HOME:创建一个指向 JDK 根目录的系统变量。 - 更新
Path:在Path变量中添加%JAVA_HOME%\bin。 - 验证:关闭旧 CMD,打开新 CMD,运行
java -version和javac -version。
祝你学习愉快!
