多项目开发环境：如何使用update-alternatives管理多版本Java JDK？（Windows、Mac、Ubuntu）

猫头虎2026-02-10 20:45

如何使用update-alternatives管理多版本Java JDK？（Windows、Mac、Ubuntu）

📖 摘要

在实际开发中，往往会遇到既要维护老项目又要跟进新特性的场景，这就需要在一台机器上同时安装并切换多个Java JDK版本。本文将针对三大主流平台------Windows、macOS 和 Ubuntu，详细介绍如何安装多个 JDK，并使用各自平台上的"替代方案"工具来管理与切换。

  • Windows：通过系统环境变量与批处理脚本实现版本切换
  • macOS ：利用 /usr/libexec/java_home 与 jEnv 工具
  • Ubuntu ：深入剖析 update-alternatives 原理与实战

无论您是新手还是有一定经验的开发者，都能从中获得清晰的思路与操作指南。

文章目录

  • [如何使用update-alternatives管理多版本Java JDK？（Windows、Mac、Ubuntu）](#如何使用update-alternatives管理多版本Java JDK？（Windows、Mac、Ubuntu）)
    • [📖 摘要](#📖 摘要)
    • [📗 引言](#📗 引言)
    • [作者名片 ✍️](#作者名片 ✍️)
    • [加入我们AI共创团队 🌐](#加入我们AI共创团队 🌐)
    • [加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀](#加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀)
  • 正文
    • [1. 🪟 Windows 平台](#1. 🪟 Windows 平台)
      • [1.1 环境变量基础](#1.1 环境变量基础)
      • [1.2 安装多个 JDK](#1.2 安装多个 JDK)
      • [1.3 手动切换](#1.3 手动切换)
      • [1.4 使用批处理脚本自动切换](#1.4 使用批处理脚本自动切换)
    • [2. 🍎 macOS 平台](#2. 🍎 macOS 平台)
      • [2.1 `/usr/libexec/java_home` 命令](#2.1 /usr/libexec/java_home 命令)
      • [2.2 使用 jEnv 统一管理（推荐）](#2.2 使用 jEnv 统一管理（推荐）)
    • [3. 🐧 Ubuntu 平台（Debian系）](#3. 🐧 Ubuntu 平台（Debian系）)
      • [3.1 `update-alternatives` 原理](#3.1 update-alternatives 原理)
      • [3.2 安装与注册 JDK](#3.2 安装与注册 JDK)
        • [3.2.1 使用 APT 安装（OpenJDK）](#3.2.1 使用 APT 安装（OpenJDK）)
        • [3.2.2 手动下载并注册 Oracle JDK](#3.2.2 手动下载并注册 Oracle JDK)
      • [3.3 切换与查看](#3.3 切换与查看)
    • [4. ✅ 验证与示例](#4. ✅ 验证与示例)
    • [5. 🛠️ 常见问题与解决](#5. 🛠️ 常见问题与解决)
    • [6. ❓ 常见 QA](#6. ❓ 常见 QA)
    • [🏁 总结](#🏁 总结)
  • 粉丝福利
      • [联系我与版权声明 📩](#联系我与版权声明 📩)

📗 引言

多版本 JDK 切换为何如此重要？

  • 兼容性测试：老项目可能依赖 Java 8，而新项目需要 Java 17。
  • 生态差异：Spring Boot 2.x 与 3.x 对 Java 版本的要求不同。
  • CI/CD 集成：自动化构建需要在不同 JDK 下验证构建过程。

三大平台各有生态与管理方式，因此本文将分别展开，帮助您在不同系统上搭建灵活的多版本 Java 环境。

作者名片 ✍️

  • 博主 ：猫头虎
  • 全网搜索关键词 ：猫头虎
  • 作者微信号 ：Libin9iOak
  • 作者公众号 ：猫头虎技术团队
  • 更新日期 ：2025年07月21日
  • 🌟 欢迎来到猫头虎的博客 --- 探索技术的无限可能！

加入我们AI共创团队 🌐

加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀

正文

1. 🪟 Windows 平台

1.1 环境变量基础

Windows 管理可执行程序的核心是 系统路径（PATH） 与 环境变量（Environment Variables） 。切换 JDK 版本，本质上就是让系统在 PATH 中优先找到对应版本的 java.exe 与 javac.exe。

1.2 安装多个 JDK

  1. 从 Oracle 官网或 AdoptOpenJDK 下载所需版本的 Windows 安装包（.exe）。

  2. 依次安装到不同目录，如：

    • C:\Program Files\Java\jdk1.8.0_381
    • C:\Program Files\Java\jdk-17.0.7

1.3 手动切换

  1. 打开系统环境变量：

    • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

  2. 找到 系统变量 中的 JAVA_HOME、Path：

    • 修改 JAVA_HOME 为目标 JDK 目录。
    • 在 Path 里，将 %JAVA_HOME%\bin 放到最前面。

  3. 点击「确定」，重新打开命令行窗口，即可 java -version 验证。

1.4 使用批处理脚本自动切换

为了避免每次手动修改环境变量，可编写简单的 .bat 脚本：

bat 复制代码 
@echo off
REM 切换到 Java 8
setx JAVA_HOME "C:\Program Files\Java\jdk1.8.0_381" /M
setx PATH "%%JAVA_HOME%%\bin;%%PATH%%" /M
echo 已切换到 Java 8
  • 保存为 switch-to-java8.bat，右键以管理员身份运行。
  • 同理可写 switch-to-java17.bat。
  • 运行后重启命令行窗口即可生效。

2. 🍎 macOS 平台

2.1 /usr/libexec/java_home 命令

macOS 自带命令 /usr/libexec/java_home，可列出并切换已安装的 JDK 版本。

bash 复制代码 
# 列出所有已安装JDK
/usr/libexec/java_home -V

# 切换到 Java 11
export JAVA_HOME=$(/usr/libexec/java_home -v 11)
export PATH=$JAVA_HOME/bin:$PATH
  • -V：显示版本列表及安装路径。
  • -v <version>：选择指定版本。

将上述两行写入 ~/.zshrc 或 ~/.bash_profile，并配合 alias：

bash 复制代码 
alias j8='export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)'
alias j11='export JAVA_HOME=$(/usr/libexec/java_home -v 11)'
alias j17='export JAVA_HOME=$(/usr/libexec/java_home -v 17)'

打开新终端后，输入 j11 即可切换。

2.2 使用 jEnv 统一管理（推荐）

jEnv 是跨平台的 Java 版本管理工具，支持 macOS、Linux。

  1. 安装 jEnv（需先安装 Homebrew）：

    bash 复制代码 
    brew install jenv

  2. 将 jEnv 集成到 shell 配置：

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

  3. 添加已安装的 JDK：

    bash 复制代码 
    jenv add /Library/Java/JavaVirtualMachines/jdk1.8.0_381.jdk/Contents/Home
jenv add /Library/Java/JavaVirtualMachines/jdk-17.0.7.jdk/Contents/Home

  4. 列出与切换：

    bash 复制代码 
    jenv versions
jenv global 11          # 全局切换到 Java 11
jenv local 1.8 .        # 针对当前目录切换到 Java 1.8
jenv shell 17           # 仅对当前 shell 有效

jEnv 会自动管理 JAVA_HOME 与 PATH，并支持插件扩展（Maven、Gradle 插件等）。

3. 🐧 Ubuntu 平台（Debian系）

3.1 update-alternatives 原理

  • Debian/Ubuntu 引入 alternatives 系统，允许对系统命令（如 java、javac）创建"组"，并在组内注册多个"备选项"。
  • 每个备选项由 可执行文件路径 和 优先级 组成。
  • 运行 update-alternatives --config <name> 即可交互式切换。

3.2 安装与注册 JDK

3.2.1 使用 APT 安装（OpenJDK）
bash 复制代码 
sudo apt update
sudo apt install -y openjdk-8-jdk openjdk-11-jdk openjdk-17-jdk

APT 安装后通常会自动注册到 alternatives，您可以直接执行下一步。

3.2.2 手动下载并注册 Oracle JDK

  1. 下载并解压到 /usr/lib/jvm：

    bash 复制代码 
    sudo mkdir -p /usr/lib/jvm
sudo tar -xzf ~/Downloads/jdk-17.0.7_linux-x64_bin.tar.gz -C /usr/lib/jvm

  2. 注册到 alternatives（以 Java 17 为例，优先级设为 2）：

    bash 复制代码 
    sudo update-alternatives --install /usr/bin/java   java   /usr/lib/jvm/jdk-17.0.7/bin/java   2
sudo update-alternatives --install /usr/bin/javac  javac  /usr/lib/jvm/jdk-17.0.7/bin/javac  2
sudo update-alternatives --install /usr/bin/jar    jar    /usr/lib/jvm/jdk-17.0.7/bin/jar    2
    • 第三个参数为命令组名（可省略后缀）。
    • 最后一个数字为优先级，数值越大越优先。

3.3 切换与查看

查看当前注册项
bash 复制代码 
update-alternatives --query java

输出包含所有 java 备选路径及当前选择。

交互式切换
bash 复制代码 
sudo update-alternatives --config java

会列出所有已注册的 Java 可执行文件，按提示输入对应序号即可切换。

同理切换 javac、jar 等。

4. ✅ 验证与示例

无论在哪个平台，切换后都应首先验证：

bash 复制代码 
java -version
javac -version

并可编写最简单的 HelloWorld 程序进行编译与运行测试。

5. 🛠️ 常见问题与解决

场景 原因与排查 解决思路
切换后 java -version 仍指向旧版本 PATH 未更新或 shell 缓存未刷新 重新打开终端；Windows 重启 CMD；Linux hash -r
Windows 脚本执行报 "权限不足" 未以管理员身份运行 .bat 右键 → "以管理员身份运行"
macOS /usr/libexec/java_home 列不全 JDK 未正确安装到 /Library/Java/... 检查 JDK 文件夹；重启 shell
Ubuntu 手动注册后未见新选项 alternatives 配置不一致 再次执行 --install；检查路径拼写

6. ❓ 常见 QA

  • Q：为什么 Linux 上要用 update-alternatives？

    A：它能同时管理多个版本的同名命令，避免手动修改 PATH，且支持优先级与脚本化。

  • Q：Windows 有没有类似 update-alternatives 的工具？

    A：官方没有，但可借助 jabba 或自定义批处理脚本。

  • Q：macOS 上除了 jEnv 还有其他方案吗？

    A：也可使用 SDKMAN! 管理，但 SDKMAN! 对 Windows 支持有限。

🏁 总结

本文深入对比了 Windows、macOS 和 Ubuntu 三大平台上多版本 Java JDK 管理的思路与实践：

  • Windows：环境变量 + 批处理脚本
  • macOS：/usr/libexec/java_home + jEnv
  • Ubuntu：update-alternatives 原理详解

掌握上述方法后，无论在本地开发还是在 CI/CD 环境，都能灵活切换 JDK 版本，确保兼容性与高效协同开发。祝您 Java 开发之路顺畅！🚀

粉丝福利

👉 更多信息：有任何疑问或者需要进一步探讨的内容，欢迎点击文末名片获取更多信息。我是猫头虎博主，期待与您的交流！ 🦉💬

联系我与版权声明 📩

  • 联系方式 ：
    • 微信: Libin9iOak
    • 公众号: 猫头虎技术团队
  • 版权声明 ：
    本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问猫头虎的博客首页。

点击✨⬇️下方名片⬇️✨，加入猫头虎AI共创社群矩阵。一起探索科技的未来，共同成长。🚀
🔗 猫头虎抱团AI共创社群 | 🔗 Go语言VIP专栏 | 🔗 GitHub 代码仓库 | 🔗 Go生态洞察专栏
✨ 猫头虎精品博文

相关推荐
青云计划10 小时前
知光项目知文发布模块
java·后端·spring·mybatis
赶路人儿10 小时前
Jsoniter（java版本）使用介绍
java·开发语言
探路者继续奋斗11 小时前
IDD意图驱动开发之意图规格说明书
java·规格说明书·开发规范·意图驱动开发·idd
消失的旧时光-194311 小时前
第十九课：为什么要引入消息队列？——异步系统设计思想
java·开发语言
A懿轩A11 小时前
【Java 基础编程】Java 面向对象入门：类与对象、构造器、this 关键字，小白也能写 OOP
java·开发语言
乐观勇敢坚强的老彭12 小时前
c++寒假营day03
java·开发语言·c++
biubiubiu070612 小时前
谷歌浏览器无法访问localhost:8080
java
大黄说说12 小时前
新手选语言不再纠结：Java、Python、Go、JavaScript 四大热门语言全景对比与学习路线建议
java·python·golang
烟沙九洲12 小时前
Java 中的 封装、继承、多态
java
识君啊13 小时前
SpringBoot 事务管理解析 - @Transactional 的正确用法与常见坑
java·数据库·spring boot·后端
热门推荐
01GitHub 镜像站点02Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services03openclaw配置教程（linux+局域网ollama）04AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南05UV安装并设置国内源06Linux下V2Ray安装配置指南07243 行 microGPT：把“训练 + 推理”拆到骨头里08openclaw使用nginx反代部署过程 与disconnected (1008): pairing required解决09OpenClaw（Clawdbot）windows安装完整配置指南10Claude Code Skills 实用使用手册