必须安装oracle jdk 21并正确配置java_home与path环境变量：先确认芯片架构下载对应dmg包，安装至默认路径/library/java/javavirtualmachines/，用/usr/libexec/java_home -v 21获取精确路径，再在~/.zshrc中导出该java_home及$java_home/bin到path，最后source生效并用java -version和javac -version验证。
要在macOS上运行Java项目或编译.java文件，必须让终端识别java和javac命令，而这依赖于正确安装Oracle JDK 21并设置JAVA_HOME与PATH环境变量——漏掉任一环节都会导致命令未找到或版本混乱。
确认芯片架构并下载对应安装包
点击左上角苹果图标 → “关于本机”，查看“芯片”一项：若显示“Apple M1”“M2”或“M3”，则为ARM64架构；若显示“Intel”，则为x64架构。这两类芯片必须下载不同安装包，否则双击安装时会提示“无法打开，因为 Apple 无法验证此软件”的错误。
访问Oracle官网JDK 21 macOS下载页，根据芯片类型选择：【ARM64 DMG Installer】（M系列芯片）或【x64 DMG Installer】（Intel芯片）。无需登录账户即可下载，避免第三方镜像站捆绑软件。
下载完成后，文件名类似 jdk-21.0.8_macos-aarch64_bin.dmg 或 jdk-21.0.8_macos-x64_bin.dmg，请勿重命名，后续路径引用依赖原始名称。
安装JDK到系统默认位置
双击下载的.dmg文件，运行其中的.pkg安装程序。
全程点击“继续”→“安装”，系统会自动将JDK安装到 /Library/Java/JavaVirtualMachines/jdk-21.jdk（实际版本号可能含小数，如 jdk-21.0.8.jdk），这是macOS官方认可的JVM管理路径，不要手动拖拽或改路径，否则java_home命令无法定位。
安装完成后关闭安装窗口，打开终端输入：/usr/libexec/java_home -v 21，回车后应返回完整路径，例如：/Library/Java/JavaVirtualMachines/jdk-21.0.8.jdk/Contents/Home。请复制这一整行路径，后面配置环境变量时必须一字不差粘贴。
配置JAVA_HOME与PATH环境变量
macOS默认使用zsh shell（自macOS Catalina起），因此需编辑 ~/.zshrc 文件；若曾手动切换为bash，则编辑 ~/.bash_profile。
在终端执行：vim ~/.zshrc，按 i 进入插入模式，在文件末尾新起两行，填入：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.0.8.jdk/Contents/Homeexport PATH=$JAVA_HOME/bin:$PATH
⚠️ 注意：第一行中的路径必须与上一步 /usr/libexec/java_home -v 21 返回的路径完全一致，包括版本号小数点和大小写——写错一个字符都会导致javac命令失效。
按 Esc 键退出插入模式，输入 :wq 回车保存并退出vim。
立即生效配置：source ~/.zshrc。这步不可跳过，否则新开终端仍读不到新变量。
验证安装是否成功
在当前终端窗口直接输入：java -version，回车后应显示类似：
java version "21.0.8" 2025-07-15 LTSJava(TM) SE Runtime Environment (build 21.0.8+12-LTS-250)Java HotSpot(TM) 64-Bit Server VM (build 21.0.8+12-LTS-250, mixed mode, sharing)
再输入：javac -version，回车后应输出 javac 21.0.8。
两项均显示21.x.x且无“command not found”报错，说明JDK 21已可正常使用。
