Mac上自动切换JDK版本

在Mac上自动切换JDK版本，最推荐使用专业的管理工具，它能让切换过程更可靠，也更容易管理。

jEnv 是一款轻量级工具，核心价值在于能让 Java 版本随项目目录自动切换，特别适合在多个需要不同JDK版本的项目间频繁切换的开发者。

• 安装与配置：

  # 1. 安装 jEnv
  brew install jenv
  
  # 2. 配置 Shell 环境
  echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
  echo 'eval "$(jenv init -)"' >> ~/.zshrc
  
  # 3. 让配置生效
  source ~/.zshrc
  

  (注：如果你用的是 bash Shell，需要编辑的是 ~/.bash_profile 文件)。

  怎么知道我当前用的是哪个 Shell？
  打开终端，输入 echo $SHELL，回车。

  • 输出 /bin/zsh → 你在用 Zsh（新版 Mac 默认）
  • 输出 /bin/bash → 你在用 Bash

• 添加和管理 JDK：

  # 1. 查看系统已安装的所有JDK
  /usr/libexec/java_home -V
  
  # 2. 添加JDK到 jEnv (以JDK 11为例)
  jenv add /Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
  jenv add /Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home
  
  # 3. 查看jEnv管理的所有JDK版本
  jenv versions
  

• 切换 JDK 版本：

  # 全局切换：影响整个系统 (慎用)
  jenv global 11.0
  
  # 当前终端会话切换：仅当前终端有效
  jenv shell 1.8
  
  # 【最推荐】项目级自动切换：cd 到项目目录，锁定JDK版本
  cd /path/to/your/project
  jenv local 17.0
  

  执行 jenv local 后，jEnv 会在当前目录下生成一个 .java-version 文件，记录了该项目的 JDK 版本。当你再次进入该目录时，它会自动切换。

❓ 常见问题

• 问题1：/usr/libexec/java_home -V 找不到我安装的JDK？
  JDK未被 macOS 正确注册时会出现此情况。通常重启终端或电脑即可解决，极少情况需执行 sudo /usr/libexec/java_home --register 手动注册。

• 问题2：jenv versions 显示已切换，但 java -version 版本没变？
  很可能是 Shell 环境变量未刷新或 PATH 解析顺序有误。请重新打开终端或执行 source ~/.zshrc。同时检查 ~/.zshrc 中 export PATH 的顺序，确保 jEnv 的 shim 路径在最前面。

• 问题3：IDE (如 IntelliJ IDEA) 内版本不匹配？
  IDE 启动时读取的是登录 Shell 的环境变量。修改后建议重启 IDE，或直接在 IDE 的 Project Structure -> SDKs 中手动指定JDK安装路径。