初学者应选JDK 17 LTS版本，因其稳定、教程丰富、Spring Boot 3+默认支持；安装时路径避免中文和空格，需配置JAVA_HOME和Path两个环境变量，验证用java -version和javac -version命令。

JDK 安装配置其实就三步：选对版本、装到合适位置、配好两个关键环境变量。只要路径不带中文和空格，变量名写对、值填准，基本不会出错。

选哪个 JDK 版本更稳妥

初学者直接选 JDK 17（LTS 长期支持版）最省心。它稳定、教程多、Spring Boot 3+ 默认支持，且 Oracle 和主流开源发行版（如 Temurin、Zulu）都持续更新。别追 JDK 21 或 23——新特性虽好，但很多入门示例、老教材和 IDE 插件默认还没适配，容易卡在“UnsupportedClassVersionError”这类报错上。JDK 8 虽然老，但只建议用于维护遗留项目，新学习不必绕道。

安装时注意路径和选项

• 下载 .exe 或 .msi 安装包后，双击运行，全程点“下一步”即可；
• 务必修改安装路径：例如 D:\Java\jdk-17.0.9，避开 C:\Program Files（有空格）和任何中文目录；
• 如果用的是较新安装包（如 Temurin），勾选 “Set JAVA_HOME variable” 和 “Add to PATH” 可自动配置——但建议手动配，更清楚、更可控；
• JDK 17 已内置 JRE，无需额外安装或配置独立 JRE。

必须配置的两个环境变量

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”，在系统变量区操作：

java-api-doc-generator

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

下载

• JAVA_HOME：新建变量，变量名严格写成 JAVA_HOME（全大写、无空格），变量值填你刚才记下的 JDK 根目录，例如 D:\Java\jdk-17.0.9；
• Path：编辑已有 Path 变量，新增一行：%JAVA_HOME%\bin（注意是百分号包裹，不是引号）；
• 不用再加 %JAVA_HOME%\jre\bin（JDK 17+ 已移除独立 jre 目录），加了反而可能引发冲突。

验证是否真的生效

关掉所有已打开的命令行窗口，重新打开 cmd 或 PowerShell，依次执行：

• java -version → 应显示类似 java version "17.0.9" ... LTS；
• javac -version → 应输出相同版本号（注意是 javac，不是 java c）；
• 如果 java 成功但 javac 报“不是内部或外部命令”，大概率是 Path 里漏了 %JAVA_HOME%\bin，或者没重启命令行。

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