我的文档

主题

macOS Java 环境安装指南 ​

一、安装单版本 Java 环境 ​

1. 更新 Homebrew ​

bash
brew update

2. 安装 JDK ​

bash
# 安装最新版本
brew install openjdk

# 安装特定版本（如 Java 11）
brew install openjdk@11

3. 配置环境变量 ​

首先创建符号链接：

bash
sudo ln -sfn /opt/homebrew/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

然后将以下内容添加到 ~/.zshrc（或 ~/.bash_profile）：

bash
export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"

使配置生效：

bash
source ~/.zshrc

4. 验证安装 ​

bash
java -version

预期输出示例：

openjdk version "17.0.1" 2021-10-19
OpenJDK Runtime Environment Homebrew (build 17.0.1+12)
OpenJDK 64-Bit Server VM Homebrew (build 17.0.1+12, mixed mode)

二、安装多版本 Java 环境（使用 jenv） ​

1. 安装多个 JDK 版本 ​

bash
brew install openjdk@17
brew install openjdk@21

安装路径通常为 /opt/homebrew/opt/openjdk@17 和 /opt/homebrew/opt/openjdk@21。

2. 安装 jenv ​

bash
brew install jenv

3. 配置 jenv ​

将 jenv 集成到 Shell 环境（~/.zshrc）：

bash
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(jenv init -)"' >> ~/.zshrc
source ~/.zshrc

4. 添加 Java 版本到 jenv ​

bash
jenv add /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home
jenv add /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home

查看已添加的版本：

bash
jenv versions

5. 切换 Java 版本 ​

模式命令说明
全局jenv global 17.0系统范围内生效
项目级jenv local 21.0仅在当前目录生效，离开后恢复全局配置
临时jenv shell 17.0仅当前终端会话有效，关闭后恢复

6. 验证版本 ​

bash
java -version

7. 自动管理 JAVA_HOME（可选） ​

bash
jenv enable-plugin export

切换 Java 版本时，JAVA_HOME 会自动更新到对应路径，Maven / Gradle 等工具可直接使用。

三、常见问题 ​

jenv add 报错：No such file or directory ​

现象：

bash
$ jenv add /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home
ln: /Users/nanyancc/.jenv/versions/openjdk64-21.0.4: No such file or directory

解决方法： 手动创建缺失的目录后再执行 jenv add。

bash
mkdir -p /Users/nanyancc/.jenv/versions/openjdk64-21.0.4

注意：将用户名 nanyancc 和版本号 21.0.4 替换为你实际的用户名和 Java 版本。