杰瑞科技汇

Windows配置Java环境变量,步骤是什么?

核心概念:为什么要配置环境变量?

环境变量就像是给操作系统设置了一些“快捷方式”或“默认路径”。

Windows配置Java环境变量,步骤是什么?-图1
(图片来源网络,侵删)
  • JAVA_HOME:告诉系统,你的 JDK (Java Development Kit) 安装在哪个目录下,很多 Java 应用服务器(如 Tomcat)和构建工具(如 Maven)都需要通过这个变量来找到 JDK。
  • Path:告诉系统,在哪些目录下去寻找可执行的程序文件(如 .exe 文件),我们将 JDK 的 bin 目录添加到 Path 中,这样你就可以在任何文件夹下直接运行 java, javac 等命令,而无需每次都输入完整的路径。

第一步:下载并安装 JDK

在配置环境变量之前,你必须先安装好 JDK。

  1. 访问官网:前往 Oracle 官网或 OpenJDK 官网下载 JDK。
  2. 选择版本:选择你需要的版本,LTS (长期支持) 版本如 Java 8, 11, 17 或 21。
  3. 下载安装包:选择与你 Windows 系统匹配的安装包(通常是 .msi.exe 文件)。
  4. 安装:双击安装包,一路点击 "下一步" 即可。强烈建议使用默认的安装路径C:\Program Files\Java\jdk-17.0.2,路径中最好不要有中文或空格。

第二步:查找并记录 JDK 安装路径

安装完成后,你需要找到 JDK 的根目录路径。

  1. 打开文件资源管理器。
  2. 导航到你的 JDK 安装目录,通常是 C:\Program Files\Java\C:\Program Files (x86)\Java\
  3. 在此目录下,你会看到一个类似 jdk-17.0.2 的文件夹,这就是你的 JDK 根目录。
  4. 复制这个完整的路径C:\Program Files\Java\jdk-17.0.2,你将在下一步用到它。

第三步:配置环境变量

这是最关键的一步。

  1. 打开环境变量设置窗口

    Windows配置Java环境变量,步骤是什么?-图2
    (图片来源网络,侵删)
    • 在 Windows 搜索栏中输入 编辑系统环境变量,然后打开它。
    • 或者右键点击 "此电脑" -> "属性" -> "高级系统设置" -> 在 "高级" 选项卡下点击 "环境变量..."。
  2. 创建 JAVA_HOME 变量

    • 在弹出的窗口中,找到 "系统变量" 部分(区别于下面的 "用户变量")。
    • 点击 "新建..." 按钮。
    • 变量名:输入 JAVA_HOME (全部大写)。
    • 变量值粘贴 你在第二步中复制的 JDK 根目录路径(C:\Program Files\Java\jdk-17.0.2)。
    • 点击 "确定" 保存。
  3. 编辑 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,可能会有旧路径),如果有,可以将它删除或确保你的新路径在它上面。
    • 点击 "确定" 保存所有修改。

第四步:验证配置

所有配置完成后,你需要验证一下是否成功。

  1. 重启命令提示符非常重要! 你必须完全关闭并重新打开一个新的命令提示符 或 PowerShell 窗口,否则,它将加载的是旧的、未更新的环境变量。

    Windows配置Java环境变量,步骤是什么?-图3
    (图片来源网络,侵删)
  2. 输入验证命令:在新打开的窗口中,依次输入以下两个命令:

    • 检查 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 环境的配置!

分享:
扫描分享到社交APP
上一篇
下一篇