选对JDK安装包的关键是匹配操作系统类型与CPU架构：Windows选x64/x86，macOS按芯片选aarch64（M系列）或x64（Intel），Linux用uname -m确认x86_64或aarch64；文件名中的_windows-x64、_macos-aarch64等后缀是判断依据，版本号不影响能否安装。
选对JDK安装包，关键就两点：操作系统类型 + CPU架构。选错会导致安装失败、命令无法识别，甚至根本打不开安装程序。
看清楚你的电脑系统和位数
Windows、macOS、Linux 三者安装包完全不通用，必须严格对应。同一系统下还要分32位（x86）和64位（x64/amd64/arm64）：
- Windows 用户：绝大多数现代电脑都是64位系统。按 Win + R → 输入 msinfo32 → 查看“系统类型”。显示“x64-based PC”就选 Windows x64；显示“x86-based PC”才选 x86（极少见，多见于十多年前的老设备）。
- macOS 用户：M1/M2/M3芯片选 ARM64（aarch64） 版本；Intel芯片（i5/i7等）选 x64 版本。终端运行 uname -m，输出 arm64 就是苹果芯片，x86_64 就是Intel。
- Linux 用户：终端执行 uname -m。常见结果：x86_64（主流64位Intel/AMD）、aarch64（国产ARM服务器或树莓派）、i386（已基本淘汰）。
别被“JDK 17”“JDK 21”这些数字带偏
版本号决定功能和兼容性，但不决定能不能装。能装的前提是安装包后缀匹配你的系统。比如：
- jdk-21_windows-x64_bin.exe → 只能在 Windows 64位上双击运行
- jdk-21_macos-aarch64_bin.dmg → 只能在 M系列 Mac 上挂载安装
- jdk-21_linux-x64_bin.tar.gz → 只能在 Linux x86_64 系统解压使用
看到带 _x64、_aarch64、_x86、_osx 这类词的，就是判断依据。别只盯着前面的“21”或“17”。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
下载渠道和文件名要盯紧
Oracle 官网或主流开源发行版（如 Eclipse Temurin、Amazon Corretto）页面上，每个安装包都会明确标注系统和架构。注意识别以下关键词：
- Windows：找含 windows-x64 或 windows-x86 的 .exe 文件（不是 .zip）
- macOS：找 macos-aarch64（Apple Silicon）或 macos-x64（Intel）的 .dmg
- Linux：找 linux-x64 或 linux-aarch64 的 .tar.gz
跳过那些没写清架构、只有“JDK for all platforms”之类模糊描述的链接——它大概率是源码包或文档，不能直接安装。
小提醒：路径和账号问题
下载前确认你有 Oracle 账号（官网下载需登录），或直接选用免登录的开源 JDK（如 Temurin）。安装时路径避免中文、空格、特殊符号，例如 C:\Java\jdk-21 安全，D:\我的软件\JDK 21 很可能在后续配置环境变量时报错。
