核心概念:为什么需要配置环境变量?
环境变量就像是给操作系统设置了一个“全局通讯录”。

JAVA_HOME:告诉所有需要用到 Java 的程序(Tomcat、IntelliJ IDEA、Maven),“Java 的家”在哪里,它指向的是你 JDK 的安装根目录。Path:告诉操作系统,当你在命令行输入一个命令(如java,javac)时,除了当前目录,还应该去哪些目录里寻找这个命令的可执行文件,我们将 JDK 的bin目录添加到Path中,这样你就可以在任何地方直接使用java命令了。
第一步:下载并安装 JDK
在配置环境变量之前,你必须先安装 Java 开发工具包。
- 访问官网:前往 Oracle 官网下载页面:https://www.oracle.com/java/technologies/downloads/
- 选择版本:选择你需要的 JDK 版本(JDK 17 或 JDK 21),对于大多数开发者来说,LTS(长期支持)版本是首选。
- 下载安装包:根据你的 Windows 10 系统是 32 位还是 64 位,下载对应的安装程序,现在绝大多数都是 64 位。
- 安装 JDK:
- 双击下载的
.exe文件。 - 强烈建议:在安装过程中,不要修改默认的安装路径,让它安装在
C:\Program Files\Java\jdk-<版本号>下,这可以避免后续因路径中包含空格或中文而带来的各种问题。 - 一直点击“下一步”直到安装完成。
- 双击下载的
第二步:查找 JDK 安装路径
配置环境变量需要用到 JDK 的精确路径。
- 打开文件资源管理器。
- 导航到
C:\Program Files\Java目录。 - 你会看到一个类似
jdk-17.0.2的文件夹,这个就是你的 JDK 安装目录。请记下这个完整的路径,C:\Program Files\Java\jdk-17.0.2
第三步:配置环境变量
这是最关键的一步,我们将设置 JAVA_HOME 和 Path。
-
打开环境变量设置窗口:
(图片来源网络,侵删)- 在 Windows 搜索栏中输入
编辑系统环境变量,然后打开它。 - 或者右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在 Windows 搜索栏中输入
-
创建
JAVA_HOME变量:- 在“系统变量”(不是“用户变量”)区域,点击“新建”。
- 变量名:输入
JAVA_HOME(全部大写)。 - 变量值:粘贴你刚才复制的 JDK 安装路径,
C:\Program Files\Java\jdk-17.0.2。 - 点击“确定”。
-
修改
Path变量:- 在“系统变量”列表中,找到名为
Path的变量,选中它,然后点击“编辑”。 - 重要:在弹出的编辑窗口中,你会看到一系列路径,点击“新建”,然后输入
%JAVA_HOME%\bin。 - 为什么用
%JAVA_HOME%\bin? 这是一种“引用”方式,系统会自动用JAVA_HOME变量的值来替换%JAVA_HOME%,这样做的好处是,将来如果升级 JDK,你只需要修改JAVA_HOME的值,而无需修改Path,非常方便。 - 检查顺序:确保
%JAVA_HOME%\bin这一行位于列表的上方,或者至少在系统默认的Path之前,这样可以优先使用你配置的 JDK,避免与其他版本的 Java 冲突。 - 点击“确定”保存所有修改。
- 在“系统变量”列表中,找到名为
第四步:验证配置
配置完成后,必须进行验证,以确保一切正确。
-
打开新的命令提示符:
- 非常重要! 关闭所有已经打开的命令提示符或 PowerShell 窗口,然后重新打开一个新的,因为旧的窗口不会加载新的环境变量。
-
检查 Java 版本:
- 在新打开的命令提示符中,输入以下命令并按回车:
java -version
- 如果配置成功,你会看到类似下面的输出,显示你安装的 JDK 版本号:
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 17.0.2
- 再输入以下命令:
-
检查
JAVA_HOME路径:- 输入以下命令:
echo %JAVA_HOME%
- 系统会打印出你设置的
JAVA_HOME变量值,C:\Program Files\Java\jdk-17.0.2
- 输入以下命令:
如果以上所有命令都输出了正确的结果,那么恭喜你,Java 环境变量已经成功配置!
常见问题与解决方案
问题1:'java' 不是内部或外部命令...
- 原因:
Path变量配置错误,或者没有添加%JAVA_HOME%\bin。 - 解决:
- 回到“环境变量”设置,仔细检查
Path变量中是否正确添加了%JAVA_HOME%\bin。 - 确保没有拼写错误。
- 关闭所有命令提示符,重新打开一个再试。
- 回到“环境变量”设置,仔细检查
问题2:'javac' 不是内部或外部命令...
- 原因:和
java命令失败的原因一样,Path配置有问题。 - 解决:同上,检查
Path变量。
问题3:JAVA_HOME 指向的路径不存在
- 原因:你可能记错了 JDK 的安装路径,或者安装时更改了默认路径。
- 解决:
- 打开文件资源管理器,检查
C:\Program Files\Java下的文件夹名称是否与JAVA_HOME变量值中的路径完全一致。 - 如果不一致,请修改
JAVA_HOME的变量值为正确的路径。
- 打开文件资源管理器,检查
问题4:有多个 Java 版本,如何切换?
- 原因:系统中可能安装了多个 JDK(如 JDK 8 和 JDK 17),而
Path中配置的路径指向了旧版本。 - 解决:
- 修改
JAVA_HOME的值为你想切换到的 JDK 路径。 - 或者,你可以修改
Path变量,将%JAVA_HOME%\bin这一行上下移动,来调整不同 JDKbin目录的查找优先级。 - 每次修改后,都必须关闭并重新打开命令提示符才能生效。
- 修改
| 步骤 | 操作 | 关键点 |
|---|---|---|
| 安装 | 从官网下载并安装 JDK | 不要修改默认安装路径 |
| 查找路径 | 找到 JDK 的安装根目录 | C:\Program Files\Java\jdk-17.0.2 |
| 配置变量 | 设置 JAVA_HOME 和修改 Path |
JAVA_HOME 值为路径,Path 新增 %JAVA_HOME%\bin |
| 验证 | 在新的命令提示符中运行 java -version |
确保输出正确的版本信息 |
按照以上步骤,你就可以在 Windows 10 上成功配置好 Java 开发环境了,祝你编程愉快!
