M1/M2/M3 Mac必须使用ARM64版JDK，验证方法：执行/usr/libexec/java_home -V看路径含arm64、java -version && arch输出arm64、安装目录名或内容需为ARM原生；JDK版本按场景选：8（遗留系统）、11（企业稳定）、17（主流LTS）、21（最新LTS）、22（预研）；推荐tar.gz或Homebrew安装而非DMG；环境变量须配.zshrc+动态java_home命令，且IDE需手动更新JDK路径。
M1/M2/M3 Mac 必须用 ARM64 版 JDK，否则会报 Bad CPU type in executable 或运行极慢（Rosetta 转译开销大）
怎么确认你装的是 ARM64 版 JDK？
安装后立刻验证，别等跑项目才发现不对：
- 打开终端，执行
/usr/libexec/java_home -V—— 输出路径中含arm64或AArch64才对；若出现x86_64，说明装错了架构 - 检查安装目录：
/Library/Java/JavaVirtualMachines/下的 JDK 文件夹名里通常带arm64（如zulu-17.jdk是通用名，但内容必须是 ARM 原生） - 运行
java -version后追加&& arch：应输出arm64，不是i386或x86_64
JDK 8 / 11 / 17 / 21 / 22 选哪个？看场景，不盲目追新
ARM64 版本齐全，但不同 JDK 适配成熟度和生态支持差异明显：
-
JDK 11：企业级 CI/CD、Spring Boot 2.x 项目最稳的选择；Azul 和 Temurin 的 ARM64 支持最早、最完善 -
JDK 17：当前主流 LTS，Spring Boot 3.x 强制要求；ZGC 和虚拟线程（-XX:+EnablePreview）在 M 系芯片上表现优异 -
JDK 21：最新 LTS，结构化并发（StructuredTaskScope）和虚拟线程已 GA；但部分老工具（如旧版 Kettle、某些 IDE 插件）仍不兼容 -
JDK 8：仅限维护遗留系统；Oracle 官方 ARM64 JDK 8 已停止更新，推荐用 Azul 的zulu8.78.0.1-jdk8.0.392-macosx_aarch64 -
JDK 22：非 LTS，适合技术预研；OpenJDK 官方 ARM64 构建稳定，但 Maven 插件、Lombok 等可能报 preview feature 错误
安装方式选 DMG 还是 tar.gz？别被“免配置”误导
DMG 图形安装看似简单，但对多版本管理反而是坑：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- DMG 安装默认写入
/Library/Java/JavaVirtualMachines/，权限高、需 sudo；多个 DMG 安装易混版本，且卸载不干净 -
tar.gz（尤其是 Adoptium/Temurin 的 ARM64 Compressed Archive）更可控：解压到~/jvm/，路径自己定，软链或 alias 切换无冲突 - Homebrew 安装（
brew install openjdk@17）适合开发者日常，但注意：openjdk@8无 ARM64，openjdk@11和@17可用；安装后需手动软链到系统 JVM 目录才能被/usr/libexec/java_home识别
环境变量和切换命令为什么总失效？关键在 shell 和加载顺序
Mac 默认用 zsh，但很多人还沿用 .bash_profile，导致 source 后没生效：
- 务必编辑
~/.zshrc（Catalina 及之后系统），不是.bash_profile或.profile - 别只写
export JAVA_HOME=...，要配合alias+/usr/libexec/java_home -vX动态查路径，例如：export JAVA_17_HOME=$(/usr/libexec/java_home -v17)alias java17='export JAVA_HOME=$JAVA_17_HOME' - 每次新开终端后，必须运行
source ~/.zshrc；如果用了 VS Code 终端，要重启窗口或重载 Shell - 验证是否生效：
echo $JAVA_HOME应输出真实路径，且java -version与之匹配
最容易被忽略的一点：Kettle、Eclipse、IntelliJ 等工具会缓存 JDK 路径，改完系统环境变量后，必须在它们的设置里手动指定 JRE 或 Project SDK，否则界面显示和命令行永远不一致。
