Java开发第一步是配置JDK环境变量：必须设置JAVA_HOME指向JDK安装目录（不含\bin），PATH添加%JAVA_HOME%\bin以支持全局java/javac命令，CLASSPATH现代开发通常无需配置；验证需新开终端执行java -version和javac -version均显示版本号。
学习 Java 开发第一步，就是让系统认出 JDK——这靠的是正确配置三个关键环境变量：JAVA_HOME、PATH（必须），CLASSPATH（现代开发中基本不用，可跳过）。核心目标只有一个：在任意文件夹下敲 java -version 或 javac -version 都能正常显示版本号。
JAVA_HOME 指向 JDK 安装目录
这是所有配置的基础。它不直接参与命令执行，但为其他变量提供统一路径引用，方便后续升级或切换版本。
- 打开“系统属性 → 高级 → 环境变量”
- 在“系统变量”区域点击“新建”
- 变量名填
JAVA_HOME（全大写，无空格） - 变量值填你 JDK 的实际安装路径，例如：
C:\Program Files\Java\jdk-21.0.2（注意：不要带最后的\bin） - 确认保存
PATH 添加 bin 目录让命令全局可用
操作系统靠 PATH 找命令。把 JDK 的 bin 目录加进去，java 和 javac 才能在任何位置运行。
- 在“系统变量”中找到
Path（大小写不敏感，通常显示为 Path） - 点击“编辑”，再点“新建”（Win10/11 推荐）或在变量值末尾添加：
%JAVA_HOME%\bin - 确保前面或后面有英文分号隔开（如果是手动拼接，结尾加分号更安全）
- 保存退出所有窗口
CLASSPATH 一般不用配（除非老项目明确要求）
这个变量告诉 Java 运行时去哪里找类文件（.class）。JDK 5 以后默认已包含当前目录（.）和核心库，绝大多数现代开发（Maven/Gradle 项目、IDE）完全不需要手动设置。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 新手可完全忽略此项
- 如遇特殊教学要求或遗留项目提示“找不到类”，再按需添加：
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar - 注意开头的英文句点
.和分号分隔
验证是否成功
关掉所有已打开的命令行窗口，重新打开一个新的 CMD 或 PowerShell：
- 输入
echo %JAVA_HOME%→ 应显示你设置的 JDK 路径 - 输入
java -version→ 显示 JDK 版本（如 21.0.2） - 输入
javac -version→ 显示 javac 版本（应与 java 一致） - 如果两个命令都返回版本号，说明配置完成
不复杂但容易忽略：改完环境变量一定要新开终端，旧窗口不会自动刷新；路径中不能有中文或空格（若 JDK 装在带空格路径如 Program Files，用短路径 Progra~1 或直接换到 C:\jdk 更稳妥）。
