核心概念:为什么要配置环境变量?
环境变量就像是给操作系统设置了一些“快捷方式”或“默认路径”。

JAVA_HOME:告诉系统,你的 JDK (Java Development Kit) 安装在哪个目录下,很多 Java 应用服务器(如 Tomcat)和构建工具(如 Maven)都需要通过这个变量来找到 JDK。Path:告诉系统,在哪些目录下去寻找可执行的程序文件(如.exe文件),我们将 JDK 的bin目录添加到Path中,这样你就可以在任何文件夹下直接运行java,javac等命令,而无需每次都输入完整的路径。
第一步:下载并安装 JDK
在配置环境变量之前,你必须先安装好 JDK。
- 访问官网:前往 Oracle 官网或 OpenJDK 官网下载 JDK。
- Oracle JDK: https://www.oracle.com/java/technologies/downloads/
- OpenJDK (推荐): https://jdk.java.net/ 或各大云厂商(如 Amazon, Microsoft, Alibaba)提供的版本。
- 选择版本:选择你需要的版本,LTS (长期支持) 版本如 Java 8, 11, 17 或 21。
- 下载安装包:选择与你 Windows 系统匹配的安装包(通常是
.msi或.exe文件)。 - 安装:双击安装包,一路点击 "下一步" 即可。强烈建议使用默认的安装路径,
C:\Program Files\Java\jdk-17.0.2,路径中最好不要有中文或空格。
第二步:查找并记录 JDK 安装路径
安装完成后,你需要找到 JDK 的根目录路径。
- 打开文件资源管理器。
- 导航到你的 JDK 安装目录,通常是
C:\Program Files\Java\或C:\Program Files (x86)\Java\。 - 在此目录下,你会看到一个类似
jdk-17.0.2的文件夹,这就是你的 JDK 根目录。 - 复制这个完整的路径,
C:\Program Files\Java\jdk-17.0.2,你将在下一步用到它。
第三步:配置环境变量
这是最关键的一步。
-
打开环境变量设置窗口
(图片来源网络,侵删)- 在 Windows 搜索栏中输入
编辑系统环境变量,然后打开它。 - 或者右键点击 "此电脑" -> "属性" -> "高级系统设置" -> 在 "高级" 选项卡下点击 "环境变量..."。
- 在 Windows 搜索栏中输入
-
创建
JAVA_HOME变量- 在弹出的窗口中,找到 "系统变量" 部分(区别于下面的 "用户变量")。
- 点击 "新建..." 按钮。
- 变量名:输入
JAVA_HOME(全部大写)。 - 变量值:粘贴 你在第二步中复制的 JDK 根目录路径(
C:\Program Files\Java\jdk-17.0.2)。 - 点击 "确定" 保存。
-
编辑
Path变量- 在 "系统变量" 部分,找到名为
Path的变量,选中它,然后点击 "编辑..." 按钮。 - 你会看到一个列表,里面包含了多个路径。
- 点击 "新建"。
- 在新出现的空白输入框中,输入
%JAVA_HOME%\bin。- 为什么用
%JAVA_HOME%? 这是一个引用变量,它会自动替换成你之前设置的JAVA_HOME的值,这样做的好处是,将来如果需要更换 JDK 版本,你只需要修改JAVA_HOME的值即可,无需再修改Path。
- 为什么用
- (可选但推荐) 为了确保兼容性,你也可以添加一个指向
jre\bin目录的路径,即%JAVA_HOME%\jre\bin,虽然新版 JDK 的结构可能不需要,但这是一个好习惯。 - 检查顺序:确保
%JAVA_HOME%\bin这一行在列表的上方,并且没有与其他 Java 路径冲突(如果你之前安装过其他版本的 Java,可能会有旧路径),如果有,可以将它删除或确保你的新路径在它上面。 - 点击 "确定" 保存所有修改。
- 在 "系统变量" 部分,找到名为
第四步:验证配置
所有配置完成后,你需要验证一下是否成功。
-
重启命令提示符:非常重要! 你必须完全关闭并重新打开一个新的命令提示符 或 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) -
检查编译器版本
javac -version
这个命令会检查 Java 编译器是否可用:
javac 17.0.2 -
检查
JAVA_HOME路径echo %JAVA_HOME%
这个命令会打印出
JAVA_HOME变量的值,确认它是否正确:C:\Program Files\Java\jdk-17.0.2
-
如果以上所有命令都输出了正确的结果,那么恭喜你,Java 环境变量已经成功配置!
常见问题与解决方案
-
问题1:
'java' 不是内部或外部命令,也不是可运行的程序或批处理文件。- 原因:
Path变量没有配置正确,或者命令提示符没有重启。 - 解决:检查
Path变量中是否正确添加了%JAVA_HOME%\bin,然后完全关闭并重新打开命令提示符。
- 原因:
-
问题2:
'javac' 不是内部或外部命令...- 原因:通常与
java -version报错的原因相同。javac.exe文件也位于bin目录下。 - 解决:同上,检查并重启。
- 原因:通常与
-
问题3:
JAVA_HOME指向的路径不正确。- 原因:复制路径时出错,或者 JDK 被移动到了其他位置。
- 解决:回到 "编辑系统环境变量",检查
JAVA_HOME的值是否与你的实际安装路径完全一致。
-
问题4:同时安装了多个版本的 Java,如何切换?
- 解决:最简单的方法是修改
JAVA_HOME的值为你想切换到的那个 JDK 的路径,然后重启命令提示符,如果你想更灵活地管理,可以考虑使用 SDKMAN! (for Windows) 或类似工具。
- 解决:最简单的方法是修改
希望这份详细的教程能帮助你顺利完成 Java 环境的配置!
