java -version 和 javac -version 输出不一致表明系统中 java 与 javac 来自不同 JDK 路径，常见原因包括 PATH 中旧 JDK 路径优先级更高、JAVA_HOME 指向错误、含空格路径解析失败、IDE 未同步配置或环境变量未刷新。
java -version 和 javac -version 输出不一致
这是多JDK共存时最典型的信号：系统调用的 java 和 javac 来自不同安装路径。比如 java -version 显示 17，而 javac -version 报错或显示 8，说明 Path 中 %JAVA_HOME%\bin 没生效，或者被更靠前的旧 JDK 路径覆盖了。
实操建议：
- 在命令行运行
where java和where javac，对比两个命令返回的第一行路径是否相同 - 检查
Path变量中所有含java的条目顺序，把%JAVA_HOME%\bin移到最前面（不是末尾） - 确认
JAVA_HOME值是 JDK 根目录（如C:\Program Files\Java\jdk-17），不是...\bin或...\jre - 重启命令行窗口——环境变量修改后，已打开的终端不会自动刷新
Windows 上 JAVA_HOME 包含空格导致 javac 失效
当 JDK 安装在默认路径 C:\Program Files\Java\jdk-17 时，Program Files 中的空格会让部分旧脚本或 IDE 解析失败，表现为 javac 找不到工具类，或编译时报 tools.jar not found。
实操建议：
- 不要手动在
CLASSPATH中硬写带空格的路径；JDK 9+ 已弃用tools.jar，无需配置CLASSPATH - 若必须用旧版构建工具（如 Ant），可将 JDK 重装到无空格路径，例如
C:\jdk17 - 检查
echo %JAVA_HOME%输出是否含多余引号或换行符——复制粘贴时容易混入不可见字符
VSCode Java 扩展识别不到正确 JDK 版本
即使命令行中 java -version 正常，VSCode 仍可能报 “No Java runtime present” 或使用错误版本，因为它不读取系统 Path，而是依赖 java.home 设置和项目级 java.runtime.version。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
实操建议：
- 在 VSCode 设置中搜索
java.home，填入完整 JDK 根路径（注意不是bin子目录），例如：C:\Program Files\Java\jdk-17 - 项目根目录下新建
.vscode/settings.json，显式指定：{ "java.runtime.version": "17" } - 确认 VSCode 使用的是 Java 扩展包（Red Hat 提供），而非旧版 “Java Extension Pack”；后者已停更，兼容性差
- 重启 VSCode 后，按
Ctrl+Shift+P输入 “Java: Configure Java Runtime”，查看已识别的 JDK 列表
多个 JDK 共存时如何安全切换
手动改 JAVA_HOME + 重启终端太慢，且易遗漏。Windows 本身不提供类似 Linux 的 update-alternatives，但可通过批处理 + 环境变量作用域控制实现轻量切换。
实操建议：
- 为每个 JDK 创建独立批处理文件，例如
use-jdk17.bat内容为：set JAVA_HOME=C:\Program Files\Java\jdk-17<br>set PATH=%JAVA_HOME%\bin;%PATH%
- 在需要的项目目录下直接双击运行该批处理，再启动命令行——此时新终端继承当前会话的
JAVA_HOME，不影响全局 - 避免在系统变量中反复修改
JAVA_HOME，用户变量更安全；系统变量修改需管理员权限，且影响所有账户 - IDE（如 IntelliJ）通常支持项目级 SDK 配置，优先在那里设，比动系统环境变量更可控
实际配置中最容易被忽略的点是：**JAVA_HOME 必须指向 JDK 根目录，且不能有尾部反斜杠**。比如 C:\Program Files\Java\jdk-17\ 末尾的 \ 会导致部分工具解析失败，而这个细节在错误信息里几乎不会提示。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
