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_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 更稳妥）。

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