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-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“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未重新关联。一步一验证，比全堆完再排查更省时间。
