Mac上Java环境配置需依次完成：一、下载安装OpenJDK LTS版（如Temurin 17/21）；二、配置JAVA_HOME至Shell配置文件；三、验证java/javac版本及路径；四、编译运行HelloWorld程序；五、解决Apple Silicon架构兼容与权限问题。
如果您在Mac上尝试运行Java程序，但系统提示“command not found: java”或编译失败，则可能是JDK未安装、环境变量未正确配置，或Java版本不兼容。以下是完成Mac上JDK安装与Java开发环境配置的具体步骤：
一、下载并安装JDK
Oracle JDK和OpenJDK均支持macOS，推荐使用LTS版本的OpenJDK（如Adoptium Temurin 17或21），避免许可证限制与更新中断问题。安装包为.dmg格式，双击后按向导完成安装即可，系统会自动将JDK置于/Library/Java/JavaVirtualMachines/目录下。
1、访问https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba，选择“Temurin JDK”版本。
2、在“Platform”中选择“macOS”，在“Architecture”中根据芯片类型选择“x64”（Intel）或“aarch64”（Apple Silicon）。
立即学习“Java免费学习笔记（深入）”；
3、点击对应版本的“Installer”下载.dmg文件。
4、双击下载的.dmg文件，运行安装包，按提示点击“继续”直至完成。
5、安装完成后，终端执行/usr/libexec/java_home -V可列出已安装的JDK路径及版本信息。
二、配置JAVA_HOME环境变量
macOS默认不设置JAVA_HOME，而许多构建工具（如Maven、Gradle）及IDE依赖该变量定位JDK。需手动将其写入Shell配置文件，并确保每次启动终端时自动加载。
1、打开终端，执行echo $SHELL确认当前Shell类型（zsh为默认，bash需额外判断）。
2、输入nano ~/.zshrc（若为zsh）或nano ~/.bash_profile（若为bash）进入编辑模式。
3、在文件末尾添加一行：export JAVA_HOME=$(/usr/libexec/java_home -v 17)（将“17”替换为您实际安装的LTS版本号，如“21”）。
4、按Control+O保存，回车确认文件名；按Control+X退出编辑器。
5、执行source ~/.zshrc（或source ~/.bash_profile）使配置立即生效。
三、验证Java命令可用性
配置完成后，需验证java、javac等核心命令是否被系统识别，且指向正确的JDK安装路径。此步骤可排除PATH未更新或符号链接失效的问题。
1、在终端中输入java -version，确认输出包含已安装的JDK厂商与版本号（如“Temurin-17.0.1+12”）。
2、输入javac -version，检查Java编译器是否可用，输出应与java -version一致。
3、输入echo $JAVA_HOME，确认路径指向/Library/Java/JavaVirtualMachines/下的具体JDK子目录。
4、输入which java，返回结果应为/usr/bin/java（系统代理脚本），该脚本会依据JAVA_HOME自动路由到真实JDK中的bin/java。
四、创建并运行首个Java程序
环境配置就绪后，可通过编写简单类文件验证整个开发链路是否通畅，包括源码编辑、编译、执行三个环节。无需IDE，纯命令行即可完成端到端验证。
1、在任意目录下新建文件夹，例如mkdir ~/java-test && cd ~/java-test。
2、使用nano创建HelloWorld.java：nano HelloWorld.java。
3、输入以下内容并保存：public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, Mac Java!"); } }。
4、执行编译命令：javac HelloWorld.java，成功后生成HelloWorld.class文件。
5、运行程序：java HelloWorld，终端应输出Hello, Mac Java!。
五、处理常见权限与架构兼容问题
Apple Silicon（M1/M2/M3）Mac在运行部分旧版JDK或通过Homebrew安装的JDK时，可能出现“damaged”警告或“no suitable image found”错误，根源在于签名验证失败或二进制架构不匹配。
1、若安装后双击.pkg提示“已损坏”，在终端执行：sudo xattr -d com.apple.quarantine /path/to/JDK/installer.pkg（将/path/to/替换为实际下载路径）。
2、若运行java命令报错“no suitable image found”，说明当前JDK为x86_64架构但系统为ARM64，需卸载并重新下载标记为“aarch64”的版本。
3、若使用Homebrew安装过openjdk，执行brew uninstall openjdk并手动删除/usr/local/opt/openjdk符号链接，避免干扰/usr/libexec/java_home的版本发现逻辑。
4、验证架构兼容性：对JDK目录内java二进制执行file /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin/java，输出含“arm64”表示原生支持Apple Silicon。
