直接运行 brew install openjdk@21 即可安装 openjdk 21，这是当前 macos 上 homebrew 维护的最新长期支持（lts）版本，适用于 m1/m2/m3 芯片（apple silicon）和 intel mac；安装后需手动配置 java_home 并通过 /usr/libexec/java_home -v 21 动态设置，确保 java -version 正确识别。
直接运行 brew install openjdk@21 即可安装 OpenJDK 21，这是当前 macOS 上 Homebrew 维护的最新长期支持（LTS）版本，适用于 M1/M2/M3 芯片（Apple Silicon）和 Intel Mac。
安装前确认环境
确保已安装 Homebrew 并更新到最新状态：
- 若未安装 Homebrew，执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装后添加环境变量（Apple Silicon 默认路径）：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc - 更新包索引：
brew update
安装 openjdk@21
执行命令即可完成安装：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
brew install openjdk@21- 安装完成后，Homebrew 会自动将该 JDK 注册进 macOS 的 Java 配置系统（通过
PlistBuddy写入/Library/Java/JavaVirtualMachines/），因此/usr/libexec/java_home -v 21通常能立即识别 - 验证注册是否成功：
ls /Library/Java/JavaVirtualMachines/应看到类似openjdk-21.jdk的目录（部分 Homebrew 版本会自动创建此软链接；如无，可手动补上）
配置 JAVA_HOME（关键一步）
仅安装不配置，终端仍可能调用系统默认或旧版本 Java。推荐动态设置，避免路径硬编码：
- 编辑 shell 配置文件：
vim ~/.zshrc - 追加两行（注意顺序，放在文件末尾，且确保没有其他地方重复覆盖 JAVA_HOME）：
export JAVA_HOME=$(/usr/libexec/java_home -v 21)export PATH=$JAVA_HOME/bin:$PATH - 生效配置：
source ~/.zshrc - 验证：
java -version应输出openjdk version "21.x.x"echo $JAVA_HOME应指向/opt/homebrew/Cellar/openjdk@21/21.x.x/libexec/openjdk.jdk/Contents/Home类似路径
常见问题提示
如果 java -version 未变或报错“no Java runtime present”：
- 先检查
/usr/libexec/java_home -V是否列出 JDK 21 —— 若无，说明未注册成功，需手动创建软链接：sudo ln -sfn /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-21.jdk - 注意：不要运行
brew link openjdk@21，Homebrew 明确禁止该操作，会失败 - 避免在
~/.zprofile和~/.zshrc中同时设置 JAVA_HOME，Zsh 启动时加载逻辑可能导致冲突
