Java环境变量配置后不会自动生效，因环境变量是进程级的，必须关闭所有旧终端并重启IDE等工具，在新窗口中执行echo %JAVA_HOME%、where java和java -version三者均正确才算真正生效。

Java 环境变量配置后不会自动在已打开的终端中生效，必须让新启动的进程读取更新后的系统设置。关键在于：环境变量是进程级的，修改注册表或配置文件后，只有后续新建的命令行窗口、IDE 或工具进程才能加载新值。

为什么改完不立刻生效？

Windows 将 JAVA_HOME 和 PATH 存在注册表（HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment）中，CMD/PowerShell 启动时仅一次性读取并缓存这些值。你在图形界面或管理员 PowerShell 中修改后，当前窗口仍沿用旧副本，所以：

• 已打开的 CMD/PowerShell 不识别新 JAVA_HOME
• Eclipse、IntelliJ、VS Code 等 IDE 若已运行，也不会自动重载 —— 需重启 IDE 才能读到新变量
• Maven、Gradle、Tomcat 启动时也只读取启动那一刻的环境，不是实时监听

真正生效的两个必要动作

配置保存只是第一步，必须配合以下操作才算完成：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 关闭所有旧终端，打开一个全新的 CMD 或 PowerShell 窗口（不能用“新建标签页”，要彻底关闭再重开）
• 重启依赖 Java 的开发工具，比如关掉 IntelliJ 再重新启动，否则它仍用旧 PATH 启动 JVM

验证是否真正生效

在全新终端中依次执行以下命令，三者都通过才算成功：

• echo %JAVA_HOME% → 显示你设置的 JDK 根目录（如 D:\tools\jdk-25.0.3），不能带 \bin
• where java → 返回路径应为 %JAVA_HOME%\bin\java.exe，且排在第一位
• java -version 和 javac -version → 输出版本号一致，且与 JDK 安装版本匹配

常见“看似生效”实则无效的情况

这些现象说明配置未真正落地，需回头检查：

• java -version 能运行，但 echo %JAVA_HOME% 为空 → PATH 里可能有其他 java.exe（比如旧版 JDK 或 JRE 自带），但 JAVA_HOME 根本没设
• where java 返回多个路径，且第一行不是 %JAVA_HOME%\bin → %JAVA_HOME%\bin 没加进 Path，或没移到顶部，被旧路径覆盖
• IDE 报 “Cannot detect JDK” 或编译报错 “javac not found” → IDE 没重启，或它读的是用户变量而非系统变量（建议统一配系统变量）

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南