装好JDK需三步：选LTS版本（如JDK21或17）、安装到无空格英文路径并取消Public JRE选项、配置JAVA_HOME和Path环境变量，最后用java/javac -version验证。
装好 JDK 是写 Java 代码的第一步，关键就三件事：选对版本、装进合适位置、让系统认得它。
下载适合你系统的 JDK
优先选长期支持（LTS）版本，比如 JDK 21（2023年发布，免费商用，支持到2026年9月）或 JDK 17。不建议用非 LTS 版本做学习或项目开发，稳定性差、社区支持弱。
- Windows 用户：去 Oracle 官网 或 华为开源镜像站 下载
x64 Installer (.exe)（确认你的系统是64位，右键“此电脑”→“属性”可查） - macOS 用户：Intel 芯片选
x64 .dmg，M 系列芯片（M1/M2/M3）必须选arm64 .dmg - Linux 用户：Ubuntu/Debian 推荐用
sudo apt install openjdk-21-jdk；其他发行版可用 tar.gz 包手动解压安装
安装时注意路径和选项
双击安装包后，别一路“下一步”到底。关键操作有两处：
- 修改安装路径：避开
C:\Program Files\（空格易出错），也别用中文路径，例如设为D:\Java\jdk-21或/usr/local/jdk-21 - JDK 11 及以后版本已内置 JRE，安装界面里如果出现“Public JRE”选项，务必取消勾选，避免后续版本冲突
配置环境变量让命令行可用
核心是两个变量：JAVA_HOME 指向 JDK 根目录，Path 加入它的 bin 目录。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
Windows：
→ 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
→ 新建系统变量：
JAVA_HOME = D:\Java\jdk-21→ 编辑 Path，新增：%JAVA_HOME%\bin -
macOS / Linux：
→ 编辑
~/.zshrc（macOS Catalina 及以后默认用 zsh）或~/.bashrc→ 加入两行：export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home（macOS 示例）export PATH=$JAVA_HOME/bin:$PATH→ 执行source ~/.zshrc生效
验证是否真的装好了
打开新终端（旧窗口不识别新环境变量），依次运行：
-
java -version→ 应显示类似java version "21.0.3" 2024-04-16 LTS -
javac -version→ 应显示对应编译器版本，如javac 21.0.3 -
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）→ 确认路径输出正确
三项都通过，说明 JDK 已就绪，可以开始写第一个 Hello World 了。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
