m1/m2 mac 必须使用 aarch64 架构 jdk，安装时需认准 macos-aarch64/arm64/apple silicon 标识，java_home 必须指向 contents/home 目录，并在 ide、maven、gradle 中单独配置正确路径。
Java 原生 JDK 在 M1/M2 上必须用 aarch64 架构版本
Mac M1/M2 是 ARM64（aarch64）架构，不是 Intel x86_64。装错架构的 JDK 会导致 java 命令无法执行、Bad CPU type in executable 错误，或 IDE（如 IntelliJ）反复提示“JDK not found”。OpenJDK 官方、Adoptium（Eclipse Temurin）、Zulu 等主流发行版都提供明确标注 aarch64 的 macOS 版本——别选带 x64 或 x86_64 字样的包。
- 下载页面认准关键词：
macos-aarch64、ARM64、Apple Silicon - Temurin 示例路径：
temurin-17.jdk（不是temurin-17-x64.jdk） - Homebrew 默认已适配：运行
brew install openjdk安装的就是 aarch64 版，无需额外参数
JAVA\_HOME 配置必须指向 Contents/Home 子目录
macOS 上 JDK 安装后是 bundle 目录结构（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk），但真正可执行的 java、javac 在 Contents/Home 下。设错路径会导致命令找不到，或 java -version 显示旧版本。
- 正确写法：
export JAVA_HOME=$(/usr/libexec/java_home -v17)（推荐，自动定位） - 手动写法示例：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home - 验证是否生效：
$JAVA_HOME/bin/java -version和which java应指向同一路径 - 别漏掉
Contents/Home—— 写成.../jdk-17.jdk根目录会失败
IntelliJ / VS Code / Maven 仍可能读取错误 JDK
IDE 和构建工具通常不完全依赖系统 JAVA_HOME，它们各自缓存或硬编码 JDK 路径。即使终端里 java -version 正确，项目编译仍报 Unsupported class file major version，大概率是工具在用另一个 JDK。
- IntelliJ：File → Project Structure → SDKs → 点 “+” → Add JDK → 手动选中
Contents/Home目录（不是 bundle 根目录） - VS Code Java Extension：点击右下角 Java 版本号 → “Configure Java Runtime” → 在 “Java Configuration JREs” 中添加正确路径
- Maven：检查
mvn -v输出的 Java home 是否与$JAVA_HOME一致；若不一致，在~/.mavenrc中显式设置export JAVA_HOME=... - Gradle：
gradle --version会显示 JVM 路径，不匹配时需在gradle.properties或启动脚本中覆盖org.gradle.java.home
旧项目跑不起来？重点查字节码版本和 JNI 依赖
原生 JDK 运行没问题，不代表所有 Java 项目能立刻跑通。两个高频卡点：一是编译目标版本高于当前 JDK 支持范围，二是项目依赖了仅提供 x86_64 的本地库（.dylib 或 .so）。
立即学习“Java免费学习笔记（深入）”；
- 编译错误如
java.lang.UnsupportedClassVersionError: Unsupported major.minor version：说明 class 文件由更高版本 JDK 编译，需升级项目 JDK 或降级maven-compiler-plugin的source/target - JNI 报错如
UnsatisfiedLinkError: no xxx in java.library.path：确认该库是否提供 aarch64 版本；很多老 SDK（如某些 Oracle JDBC 驱动、图像处理库）早期只发 x86_64，需找新版或换替代方案 - Spring Boot 2.6+、Log4j2 2.17+ 等主流库已全面支持 aarch64，但小众或内部 SDK 往往滞后
最常被跳过的一步：删掉旧 JDK 的残留符号链接。比如 /usr/libexec/java_home -V 列出多个版本，但其中一些实际已卸载却还留着软链，导致 java_home -v11 返回一个不存在的路径。手动清理 /Library/Java/JavaVirtualMachines/ 下的空目录和损坏 bundle，比反复重装更有效。
