文章目录
- 一、配置环境变量
- 1. 打开环境变量设置界面
- 2. 新建 JAVA_HOME 变量
- 3. 编辑 Path 变量
- 4. (可选)配置 CLASSPATH
- 5. 保存并验证
- 二、环境变量说明
- 三、常见问题排查
- 四、多版本 JDK 切换(进阶)
- 五、总结
安装 JDK 后,若在终端执行java --version提示“不是内部或外部命令”,说明环境变量未正确配置。本文介绍 Windows 系统下 Java 环境变量的配置方法。
一、配置环境变量
1. 打开环境变量设置界面
- 方法一(推荐):快捷键
Win + R→ 输入sysdm.cpl→ 回车 → 选择“高级”选项卡 → 点击“环境变量” - 方法二:右键“此电脑” → 属性 → 高级系统设置 → 环境变量
- 方法三:
Win + S搜索“编辑系统环境变量” → 点击打开
2. 新建 JAVA_HOME 变量
在“系统变量”区域点击【新建】:
- 变量名:
JAVA_HOME - 变量值:填写 JDK 安装根目录(例如
D:\Java\jdk-21)
注意:变量值应为 JDK 根目录,不要包含
\bin。
3. 编辑 Path 变量
在“系统变量”中找到Path,双击打开:
- 点击【新建】,添加条目:
%JAVA_HOME%\bin
提示:建议将此条目上移至靠前位置,避免与其他 Java 版本冲突。
4. (可选)配置 CLASSPATH
现代 JDK(JDK 9+)通常无需手动配置。如需配置,可新建系统变量:
- 变量名:
CLASSPATH - 变量值:
.;%JAVA_HOME%\lib
注意:开头的
.表示当前目录,不可省略。
5. 保存并验证
- 依次点击“确定”保存所有设置
- 重新打开一个 CMD 或 PowerShell 窗口(必须新开)
- 执行以下命令验证:
若两个命令均正确输出版本号(示例如下),则配置成功:java--versionjavac--versionjava version "21.0.x" 202x-xx-xx LTS Java(TM) SE Runtime Environment (build 21.0.x+xx-xx) Java HotSpot(TM) 64-Bit Server VM (build 21.0.x+xx-xx, mixed mode) javac 21.0.x
二、环境变量说明
| 变量名 | 作用 |
|---|---|
JAVA_HOME | 指向 JDK 安装根目录,便于其他变量引用,也被众多开发工具依赖 |
Path | 添加%JAVA_HOME%\bin,使系统能在任意目录下找到java、javac等命令 |
CLASSPATH | 指定类文件的搜索路径(JDK 9+ 通常无需配置) |
三、常见问题排查
| 问题现象 | 可能原因与解决方案 |
|---|---|
输入java --version提示“不是内部或外部命令” | 1. 检查Path中是否已添加%JAVA_HOME%\bin2. 确认 JAVA_HOME路径正确(路径下应有bin文件夹)3. 重新打开命令行窗口 |
java --version与javac --version版本不一致 | Path中存在多个 Java 路径,将新配置的%JAVA_HOME%\bin上移,或删除旧的 Java 路径 |
JAVA_HOME路径含空格(如Program Files) | 在Path中使用"%JAVA_HOME%\bin"(加双引号),或将 JDK 安装到无空格路径(如D:\Java\jdk-21) |
| 在 PowerShell 中验证配置 | 执行以下命令检查:$env:JAVA_HOME(查看JAVA_HOME值)$env:Path -split ";"(查看Path所有条目) |
四、多版本 JDK 切换(进阶)
若需安装多个 JDK 版本(如 JDK 17、JDK 21),可将其安装到不同目录(例如D:\Java\jdk-17、D:\Java\jdk-21)。
切换方法:
- 手动切换:修改
JAVA_HOME变量值,指向目标版本的 JDK 根目录。 - 工具管理:使用第三方工具(如
jenv)进行多版本管理,可自动切换环境变量。
提示:修改
JAVA_HOME后,需重新打开命令行窗口生效。
五、总结
配置Java环境变量的核心三步:
- 设置 JAVA_HOME → JDK安装路径
- 编辑 Path → 添加 %JAVA_HOME%\bin
- 验证 → 终端输入 java --version 或 javac --version 命令
配置完成后,就可以在任意目录下编译和运行Java程序了!