Java环境变量配置后不生效，主因是系统未加载、路径不可达或调用被覆盖；需四步定位：验证JDK本体可用（绝对路径运行java -version）、确认JAVA_HOME指向JDK根目录（非bin/jre）、检查PATH中%JAVA_HOME%\bin是否生效且优先、确保新配置已进入新开终端或重启IDE。
Java 环境变量配置后不生效，问题通常不出在“没配”，而在于系统没加载、路径不可达或调用被覆盖。快速定位只需四步：验证 JDK 本体可用、确认 JAVA_HOME 指向正确、检查 PATH 引用与顺序、确保新配置已进入当前会话。
验证 JDK 安装是否真实可用
跳过“图标能点开”这类表象，直接用绝对路径运行 java.exe：
- Windows：在 CMD 中执行 "C:\Program Files\Java\jdk-17\bin\java.exe" -version（含英文引号，防空格截断）
- Linux/macOS：执行 /usr/lib/jvm/jdk-17.0.2/bin/java -version（替换为你的实际路径）
能输出版本号，说明 JDK 安装完整；若报错“找不到文件”或“拒绝访问”，需重装 JDK 或改用无空格、无中文的安装路径（如 C:\jdk\jdk-17）。
检查 JAVA_HOME 是否指向 JDK 根目录
JAVA_HOME 必须是 JDK 的根目录，不是 JRE，也不带 \bin，末尾不能有反斜杠：
立即学习“Java免费学习笔记（深入）”；
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ✅ 正确示例：C:\jdk\jdk-17、/opt/jdk-17
- ❌ 错误示例：C:\jdk\jdk-17\bin、C:\Program Files\Java\jre1.8.0、C:\jdk\jdk-17\
在终端中运行 echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux），再手动进入该路径，确认里面存在 bin、lib、jre 三个子目录。
确认 PATH 中 %JAVA_HOME%\bin 已生效且优先
PATH 决定谁先被调用，顺序就是权力：
- Windows：打开环境变量编辑器，确保 %JAVA_HOME%\bin 是一条独立条目，且排在所有其他 Java 路径（尤其是 C:\Program Files (x86)\Common Files\Oracle\Java\javapath）之前
- Linux/macOS：运行 echo $PATH，确认 $JAVA_HOME/bin 出现在最左侧；写法必须是 export PATH=$JAVA_HOME/bin:$PATH（$JAVA_HOME/bin 在前）
- 无论哪一平台，都立即执行 where java（Windows）或 which java（macOS/Linux）——结果路径必须和 %JAVA_HOME%\bin\java.exe 或 $JAVA_HOME/bin/java 一致
确保配置已加载到当前终端或 IDE
改了 ≠ 生效，系统不会自动广播更新：
- Windows：关闭所有 CMD/PowerShell 窗口，**新开一个**；IDE（如 IntelliJ）必须完全退出再启动（桌面图标启动的 IDE 不继承终端环境变量）
- Linux/macOS：改完 ~/.zshrc 后运行 source ~/.zshrc；先用 echo $SHELL 确认 shell 类型，别改错文件（macOS Catalina 后默认 zsh，改 .bashrc 无效）
- VS Code 内置终端可能不触发 login shell，建议在设置中启用“Run login shell”并重启终端
不复杂但容易忽略。重点盯住路径是否存在、是否指向 JDK 根目录、PATH 是否用变量引用 bin、以及验证时是否用了新开的终端。
