装好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 代码生成文档”时触发。

下载

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

• 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 了。