杰瑞科技汇

Java环境变量配置Win10时,路径和变量名如何正确设置?

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

为了让 Windows 系统在任何地方(任何目录下)都能找到并使用 Java 的工具(java, javac),我们需要告诉 Java 安装路径在哪里,这个“告诉”的过程就是通过配置环境变量来完成的。

Java环境变量配置Win10时,路径和变量名如何正确设置?-图1
(图片来源网络,侵删)
  • JAVA_HOME: 指向 Java 的主安装目录,很多 Java 应用(如 Tomcat、Maven)都需要这个变量来定位 JDK。
  • Path: 系统的“命令路径”,我们把它配置好,就可以在命令提示符里直接输入 javajavac 来运行程序,而无需每次都输入完整的路径。

第一步:下载并安装 JDK (Java Development Kit)

在配置环境变量之前,你必须先安装 JDK,如果你已经安装,请直接跳到第二步。

  1. 访问官网:前往 Oracle 官方 Java 下载页面:https://www.oracle.com/java/technologies/downloads/
  2. 选择版本:选择你需要的 JDK 版本(JDK 17, JDK 21),对于初学者,LTS(长期支持)版本是最佳选择。
  3. 下载安装包:根据你的 Windows 10 系统是 64 位还是 32 位,下载对应的安装程序,目前绝大多数都是 64 位 (x64)。
  4. 安装 JDK
    • 双击下载的 .exe 文件。
    • 重要:在安装过程中,务必勾选 "Set JAVA_HOME and Path variables" (设置 JAVA_HOME 和 Path 变量),安装程序会自动帮你完成大部分配置工作,这是最简单、最不容易出错的方式。
    • 点击 "Next" 直到安装完成。

如果你已经安装,或者选择手动配置,请继续下一步。


第二步:查找 JDK 的安装路径

你需要知道 JDK 具体安装在了哪里。

  1. 打开 "文件资源管理器",导航到 C:\Program Files 目录。

    Java环境变量配置Win10时,路径和变量名如何正确设置?-图2
    (图片来源网络,侵删)
  2. 你应该能看到一个名为 Java 的文件夹。

  3. 进入 Java 文件夹,里面会有一个类似 jdk-17jdk-21 的文件夹,进入它。

  4. 复制这个顶级文件夹的完整路径。 C:\Program Files\Java\jdk-17.0.2

    提示:你也可以在命令提示符中输入以下命令来查找:

    Java环境变量配置Win10时,路径和变量名如何正确设置?-图3
    (图片来源网络,侵删)
    wmic product where name="Java SE Development Kit" get version,installlocation

    这会显示 JDK 的版本和安装路径。


第三步:配置环境变量 (手动步骤)

即使安装程序自动配置了,了解手动步骤也很有帮助,尤其是在遇到问题时。

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

    • 在 Windows 搜索栏(任务栏上的放大镜图标)中输入 “编辑系统环境变量”
    • 点击打开 “编辑系统环境变量” 选项。
  2. 打开“环境变量”窗口

    在弹出的 “系统属性” 窗口中,点击右下角的 “环境变量...” 按钮。

  3. 创建或修改 JAVA_HOME

    • 在 “系统变量” 部分(不是“用户变量”),找到名为 JAVA_HOME 的变量。
    • 如果存在:选中它,点击 “编辑...”,然后将 “变量值” 修改为你刚才复制的 JDK 路径(C:\Program Files\Java\jdk-17.0.2)。
    • 如果不存在:点击 “新建...”,然后填写以下信息:
      • 变量名: JAVA_HOME
      • 变量值: C:\Program Files\Java\jdk-17.0.2 (你自己的路径)
  4. 编辑 Path 变量

    • 在 “系统变量” 列表中,找到并选中 Path 变量,然后点击 “编辑...”。
    • 在弹出的 “编辑环境变量” 窗口中,你会看到一个路径列表。
    • 新建:点击 “新建”,然后输入 %JAVA_HOME%\bin
      • 注意%JAVA_HOME% 是一个变量引用,它会自动替换为你设置的 JAVA_HOME 的值,这样做比直接写死路径更灵活,将来如果升级 JDK,只需修改 JAVA_HOME 即可。
    • 检查顺序:确保 %JAVA_HOME%\bin 这一行在列表中,并且顺序靠前,系统中可能存在旧的 Java 路径,为了避免冲突,可以将新的路径放在最上面。
    • 重要提示:如果你之前安装过其他 Java 开发工具(如 Eclipse, Android Studio),它们的路径也可能在 Path 中,确保 %JAVA_HOME%\bin 的优先级高于它们,以使用你当前安装的 JDK。
  5. 保存所有更改

    在所有打开的窗口中,依次点击 “确定” 或 “应用” 保存设置,顺序是:Path 窗口 -> 环境变量窗口 -> 系统属性窗口。


第四步:验证配置是否成功

配置完成后,需要验证一下是否生效。

  1. 完全关闭并重新打开 你的命令提示符 或 PowerShell,因为环境变量的更改只在新的会话中生效。

  2. 输入以下命令并按回车:

    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. 再输入以下命令验证编译器:

    javac -version

    如果成功,会显示:

    javac 17.0.2

如果两个命令都能正确显示版本号,那么恭喜你,Java 环境变量配置成功了!


常见问题与解决方案

问题 1:'java' 不是内部或外部命令...

  • 原因:最常见的原因是 Path 变量没有配置正确,或者没有包含 %JAVA_HOME%\bin,或者,你在旧的命令提示符窗口中测试,新窗口未打开。
  • 解决方法
    1. 仔细检查 Path 变量,确保 %JAVA_HOME%\bin 存在且拼写正确。
    2. 完全关闭所有命令提示符窗口,然后重新打开一个新的。
    3. 检查 JAVA_HOME 变量值是否正确指向了 JDK 的根目录。

问题 2:版本不对,运行的是旧版本的 Java

  • 原因Path 变量中,旧 Java 的路径排在 %JAVA_HOME%\bin 的前面,系统会按照 Path 中的顺序查找可执行文件。
  • 解决方法
    1. 打开 “环境变量” -> 编辑 Path
    2. 找到旧 Java 的路径(C:\Program Files\Common Files\Oracle\Java\javapath),将它移动到列表的最下方。
    3. %JAVA_HOME%\bin 移动到列表的最上方。
    4. 保存并重新打开命令提示符测试。

问题 3:JAVA_HOME 无法识别,Path 中的 %JAVA_HOME% 显示为无效路径

  • 原因JAVA_HOME 变量本身没有被创建,或者创建时出现了拼写错误。
  • 解决方法
    1. 重新检查 JAVA_HOME 变量的 “变量名” 和 “变量值” 是否完全正确。
    2. 确保变量值是 JDK 的根目录,C:\Program Files\Java\jdk-17.0.2,而不是 bin 目录。

希望这份详细的教程能帮助你顺利完成 Java 环境的配置!祝你编程愉快!

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