杰瑞科技汇

windows环境变量 java

为什么需要配置环境变量?

为了让你的电脑(操作系统)在任何位置都能找到并使用 Java 工具(如 javac, java, jar 等),而不是每次都进入到 Java 安装目录下执行。

windows环境变量 java-图1
(图片来源网络,侵删)

这就像你告诉电脑:“嘿,以后所有关于 Java 的命令,都去 C:\Program Files\Java\jdk-17\bin 这个文件夹里找。”


第一步:准备工作 - 安装 JDK

在配置环境变量之前,你必须已经安装了 Java Development Kit (JDK),你可以从 Oracle 官网或 OpenJDK 官网下载并安装。

安装完成后,请确认你的 JDK 安装路径,通常是这样的:

  • Oracle JDK: C:\Program Files\Java\jdk-17.0.2
  • Eclipse Temurin (OpenJDK): C:\Program Files\Eclipse Adoptium\jdk-17.0.2.8-hotspot

为了方便后续操作,建议你把这个安装路径完整地复制下来。

windows环境变量 java-图2
(图片来源网络,侵删)

第二步:配置环境变量(图文详解)

我们将配置三个关键的环境变量:

  1. JAVA_HOME:JDK 的安装根目录。
  2. Path:系统可执行文件的搜索路径,我们在这里添加 JDK 的 bin 目录。
  3. CLASSPATH:Java 类的搜索路径(对于现代 Java 开发,此项已非必需,但了解它很重要)。

操作步骤:

  1. 打开“编辑系统环境变量”

    • 在 Windows 搜索栏中输入 env,然后选择 “编辑系统环境变量”
    • 或者右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
  2. 配置 JAVA_HOME

    • 在“系统变量”区域,点击 “新建”
    • 变量名 输入:JAVA_HOME
    • 变量值 输入你的 JDK 安装路径(注意:不要在末尾加反斜杠 \)。
      • C:\Program Files\Java\jdk-17.0.2
    • 点击“确定”保存。
  3. 配置 Path 变量

    windows环境变量 java-图3
    (图片来源网络,侵删)
    • 在“系统变量”列表中,找到并选中名为 Path 的变量,然后点击 “编辑”
    • 在弹出的编辑窗口中,点击 “新建”
    • 输入 %JAVA_HOME%,这个 符号表示引用前面已经定义好的 JAVA_HOME 变量的值,这样做的好处是,将来如果 JDK 升级,你只需要修改 JAVA_HOME 的值即可,Path 无需改动。
    • (可选但推荐)再新建一行,输入 %JAVA_HOME%\bin,这能确保 bin 目录也被明确包含。
    • 重要提示:请确保 %JAVA_HOME%%JAVA_HOME%\bin 这一行在列表的上方,或者至少在其他 JDK 相关路径的上方,以防止系统找到错误的 Java 版本。
    • 点击“确定”保存。
  4. 配置 CLASSPATH(了解即可)

    • 对于 Java 8 及以上版本,日常开发通常不需要配置 CLASSPATH,JDK 会自动在当前目录和 JDK 的库中查找类文件。
    • 如果你的项目有特殊需求,或者想了解它,可以像配置 JAVA_HOME 一样新建一个系统变量。
    • 变量名 输入:CLASSPATH
    • 变量值 输入:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
      • 代表当前目录,非常重要!
      • 是 Windows 下的路径分隔符。
      • 后面两个是 JDK 自身的核心库文件路径。
    • 如果不需要,可以跳过这一步。
  5. 保存所有设置

    在所有窗口中,一路点击“确定”保存设置,直到关闭“系统属性”窗口。


第三步:验证配置

配置完成后,需要重新打开一个新的命令行窗口(CMD 或 PowerShell)来让环境变量生效,在已经打开的窗口中配置可能不会立即生效。

  1. 检查 JAVA_HOME

    • 在新窗口中输入:
      echo %JAVA_HOME%
    • 如果配置成功,会显示你设置的 JDK 路径,C:\Program Files\Java\jdk-17.0.2
  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)
  3. 检查 Java 编译器

    • 输入以下命令:
      javac -version
    • 如果配置成功,会显示编译器的版本,应与 java -version 的版本一致。
      javac 17.0.2

如果以上三个命令都执行成功,并且输出了正确的版本信息,那么恭喜你,Java 环境变量已经成功配置!


常见问题与解决方案

问题:'java' 不是内部或外部命令,也不是可运行的程序或批处理文件。

  • 原因Path 变量没有配置正确,或者系统没有找到 java.exe 文件所在的 bin 目录。
  • 解决方法
    1. 仔细检查 Path 变量,确保 %JAVA_HOME%\bin 或直接指向 bin 目录的路径存在且拼写正确。
    2. 确保你输入的是 java -version 而不是 Java -version(注意大小写)。
    3. 重启电脑,确保环境变量完全生效。

问题:javac 命令可用,但 java 命令不可用,或者反之。

  • 原因Path 变量中可能只添加了其中一个,或者你的系统安装了多个 JDK(如 JRE 和 JDK),导致 Path 路径混乱。
  • 解决方法
    1. 检查 Path 变量,确保同时包含了 java.exejavac.exe 所在的路径。
    2. 检查 Path 变量的顺序,将你希望使用的 JDK 的 bin 目录放在最前面。
    3. 使用 where javawhere javac 命令来查看系统当前找到的是哪些 javajavac 程序。

问题:如何管理多个 JDK 版本?

  • 解决方案:手动修改 JAVA_HOMEPath 比较麻烦,推荐使用专门的版本管理工具,如:
    • SDKMAN! (适用于 Windows, macOS, Linux)
    • Jabba (适用于 macOS, Linux)
    • Adoptium Temurin Installer (Eclipse 官方提供的安装器,可以方便地切换版本)

这些工具可以让你在命令行中轻松切换不同的 JDK 版本,而无需手动修改环境变量。


变量名 作用 示例值 备注
JAVA_HOME JDK 的根目录,方便其他程序引用 C:\Program Files\Java\jdk-17.0.2 强烈建议配置,便于维护
Path 系统命令搜索路径 添加 %JAVA_HOME%\bin 必须配置,让系统找到 java, javac 等命令
CLASSPATH Java 类文件搜索路径 .;%JAVA_HOME%\lib\dt.jar;... Java 8+ 后非必需,了解即可

希望这份详细的指南能帮助你成功配置 Java 环境!

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