Mac配置Java环境需安装JDK LTS版(如17/21)、用/usr/libexec/java_home -v 17设JAVA_HOME于~/.zshrc、验证java -version,再在IDE中指定JDK路径。

在Mac上配置Java开发环境,核心是安装JDK、设置JAVA_HOME、并让终端能识别java和javac命令。关键不在于装得多,而在于路径配得准、环境变量写得对。
下载并安装JDK
推荐使用LTS版本(如JDK 17或JDK 21),从官方渠道获取:
- 前往Eclipse Temurin(原AdoptOpenJDK)下载macOS版JDK DMG安装包
- 双击安装,按向导完成(默认会装到
/Library/Java/JavaVirtualMachines/目录下) - 安装后终端执行
ls /Library/Java/JavaVirtualMachines/,能看到类似temurin-17.jdk的文件夹
配置JAVA_HOME环境变量
Mac(特别是macOS Monterey及更新系统)使用zsh作为默认shell,需修改~/.zshrc(不是~/.bash_profile):
- 打开终端,运行
open -e ~/.zshrc,或用VS Code等编辑器打开该文件 - 添加一行(以JDK 17为例,路径请根据实际安装版本调整):
export JAVA_HOME=$(/usr/libexec/java_home -v 17) - 保存后运行
source ~/.zshrc使配置生效 - 验证:执行
echo $JAVA_HOME应输出类似/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
确认Java命令可用
即使JAVA_HOME设对了,java和javac仍可能报“command not found”,因为它们不在$PATH里——但现代JDK安装后通常已自动软链到/usr/bin/,所以一般无需手动加PATH。
立即学习“Java免费学习笔记(深入)”;
- 直接运行
java -version和javac -version,输出版本号即表示成功 - 若提示命令未找到,可临时补一句:
export PATH=$JAVA_HOME/bin:$PATH(加到~/.zshrc中并source) - 注意:不要硬写死路径如
export JAVA_HOME=/Library/.../jdk-17.jdk/Contents/Home,用/usr/libexec/java_home更可靠,它能自动匹配版本
IDE中指定JDK(如IntelliJ IDEA或VS Code)
终端能用≠IDE能用,还需在开发工具里单独指定:
-
IntelliJ IDEA:Preferences → Project → Project SDK → Add JDK → 选择
/Library/Java/JavaVirtualMachines/xxx.jdk/Contents/Home -
VS Code + Extension Pack for Java:打开设置(Cmd+,),搜索
java.home,填入$JAVA_HOME对应的实际路径(不能写变量名,要写绝对路径) - 重启IDE,新建一个
.java文件,输入public class Test { public static void main(String[] args) {} },无报错且能运行即说明配置完整
基本上就这些。不复杂但容易忽略的是shell配置文件选错(.zshrc vs .bash_profile)、JDK路径写死、以及IDE未重新关联。一步一验证,比全堆完再排查更省时间。










