Windows 系统 Java 环境变量配置全攻略:解决“不是内部或外部命令”
2026/6/15 8:03:49 网站建设 项目流程

文章目录

    • 一、配置环境变量
      • 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. 保存并验证

  1. 依次点击“确定”保存所有设置
  2. 重新打开一个 CMD 或 PowerShell 窗口(必须新开)
  3. 执行以下命令验证:
    java--versionjavac--version
    若两个命令均正确输出版本号(示例如下),则配置成功:
    java 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,使系统能在任意目录下找到javajavac等命令
CLASSPATH指定类文件的搜索路径(JDK 9+ 通常无需配置)

三、常见问题排查

问题现象可能原因与解决方案
输入java --version提示“不是内部或外部命令”1. 检查Path中是否已添加%JAVA_HOME%\bin
2. 确认JAVA_HOME路径正确(路径下应有bin文件夹)
3. 重新打开命令行窗口
java --versionjavac --version版本不一致Path中存在多个 Java 路径,将新配置的%JAVA_HOME%\bin上移,或删除旧的 Java 路径
JAVA_HOME路径含空格(如Program FilesPath中使用"%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-17D:\Java\jdk-21)。

切换方法

  1. 手动切换:修改JAVA_HOME变量值,指向目标版本的 JDK 根目录。
  2. 工具管理:使用第三方工具(如jenv)进行多版本管理,可自动切换环境变量。

提示:修改JAVA_HOME后,需重新打开命令行窗口生效。

五、总结

配置Java环境变量的核心三步:

  1. 设置 JAVA_HOME → JDK安装路径
  2. 编辑 Path → 添加 %JAVA_HOME%\bin
  3. 验证 → 终端输入 java --version 或 javac --version 命令

配置完成后,就可以在任意目录下编译和运行Java程序了!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询