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 路径覆盖了。

实操建议：

立即学习“Java免费学习笔记（深入）”；

java-api-doc-generator

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

下载

• 在命令行运行 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。

实操建议：

立即学习“Java免费学习笔记（深入）”；

• 不要手动在 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免费学习笔记（深入）”；

• 在 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，但可通过批处理 + 环境变量作用域控制实现轻量切换。

实操建议：

立即学习“Java免费学习笔记（深入）”；

• 为每个 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\ 末尾的 \ 会导致部分工具解析失败，而这个细节在错误信息里几乎不会提示。