17370845950

Mac装Java环境的关键是选对ARM64/x64版JDK、用/usr/libexec/java_home动态配置JAVA_HOME于~/.zshrc、并通过终端启动IDE或手动绑定SDK路径。

Mac 上装 Java 环境，核心不是“装 JDK”，而是选对版本、配对 JAVA_HOME、避开系统自带的过时 JDK 和 zsh 配置失效问题。

确认当前是否已有 JDK 且是否可用

macOS 自带的 /usr/bin/java 是 Apple 提供的旧版 JDK（如 JDK 6），早已废弃，不能用于现代 Java 开发。必须手动安装新版 JDK。

• 运行 java -version 和 /usr/libexec/java_home -V 查看已注册的 JDK 列表；若只显示 1.6.0_65 或空输出，说明没装可用 JDK
• which java 返回 /usr/bin/java 是系统 stub，不可靠，别依赖它
• 注意：Apple Silicon（M1/M2/M3）芯片 Mac 必须使用 ARM64 架构的 JDK，x86_64 版本在 Rosetta 下可能出兼容问题

下载并安装 JDK（推荐 Adoptium / Temurin）

Oracle JDK 虽可商用，但需登录下载且许可限制多；Adoptium（Eclipse Temurin）是开源、免费、生产就绪的首选。

• 访问 https://www./link/e387385ebe0dbeefed3e8e9f3968aaba，选择最新 LTS 版本（如 21 或 17），架构选 ARM64（M系列芯片）或 x64（Intel）
• 下载 .pkg 安装包，双击安装（默认路径为 /Library/Java/JavaVirtualMachines/jdk-21.jdk）
• 安装后再次执行 /usr/libexec/java_home -V，应看到类似：

  /usr/libexec/java_home -V
  Matching Java Virtual Machines (2):
      21.0.1 (arm64) "Eclipse Temurin" - "Temurin 21.0.1" /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
      17.0.9 (arm64) "Eclipse Temurin" - "Temurin 17.0.9" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

正确配置 JAVA_HOME 和 PATH（zsh 用户重点）

Mac 默认 shell 是 zsh，~/.bash_profile 已无效；必须改 ~/.zshrc，且 JAVA_HOME 必须用 /usr/libexec/java_home 动态获取，不能硬编码路径。

• 编辑 ~/.zshrc：

  echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 21)' >> ~/.zshrc
  echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc

• 立即生效：source ~/.zshrc
• 验证：echo $JAVA_HOME 应输出完整路径；java -version 和 javac -version 输出一致且匹配你选的版本
• ⚠️ 常见错误：写成 export JAVA_HOME=/Library/Java/.../Home —— 升级 JDK 后路径变更，硬编码会失效

IDE（IntelliJ / VS Code）识别不到 JDK 怎么办

IDE 不读 shell 的 ~/.zshrc，尤其从 Finder 启动时，环境变量为空。这不是 JDK 没装好，而是启动方式问题。

• 终端中启动 IDE 才能继承环境变量：open -a "IntelliJ IDEA" 或 code（前提是 VS Code CLI 已安装）
• IntelliJ：进入 Project Structure → Project → Project SDK，点击 New → JDK，手动定位到 /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
• VS Code：安装 Extension Pack for Java，按提示重启后，项目根目录下建 .vscode/settings.json 指定：

  "java.configuration.runtimes": [
      {
          "name": "JavaSE-21",
          "path": "/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home"
      }
  ]

最易被忽略的是 shell 配置与 GUI 应用的环境隔离——哪怕 java -version 在终端里完全正确，IDE 仍可能报“no JDK found”，这时候别重装 JDK，先检查启动方式和 IDE 的 SDK 手动绑定。