1. 项目概述为什么我们需要管理多个JDK版本如果你是一名Java开发者或者正准备踏入这个领域那么“JDK”这个词对你来说一定不陌生。JDK全称Java Development Kit是Java开发的核心工具包没有它你写的Java代码就只是一堆无法运行的文本文件。但现实开发中我们很少能“从一而终”地只用一个JDK版本。你可能正在维护一个用JDK 8写的“祖传”老项目同时又要参与一个要求使用JDK 17的新项目或者你需要在本地测试你的应用在不同Java版本下的兼容性。这时候如果只会安装一个JDK或者安装多个后却手忙脚乱地切换环境变量那开发体验就会变得非常糟糕。这个内容要解决的就是Java开发者日常工作中的这个高频痛点如何干净利落地安装JDK以及如何优雅、高效地管理多个JDK版本。这不仅仅是“安装”那么简单它涉及到环境变量的理解、系统路径的配置、以及版本切换的自动化。掌握这套方法能让你在应对不同项目需求时游刃有余避免“一个项目配一天环境”的窘境。无论你是刚入门的新手还是已经写了几年Java但一直被环境问题困扰的“老鸟”这篇内容都能给你一套清晰、可复现的解决方案。2. 核心概念与准备工作在动手之前我们需要先理清几个关键概念这能帮你理解后续每一步操作背后的逻辑而不是机械地复制命令。2.1 JDK、JRE与JVM三者的关系很多人刚开始会混淆这三个词其实它们的关系非常清晰JVM (Java Virtual Machine, Java虚拟机)这是Java程序运行的“发动机”。它负责加载字节码.class文件、解释或编译执行并管理内存。不同平台Windows, macOS, Linux有各自的JVM实现这才实现了Java“一次编写到处运行”的承诺。JRE (Java Runtime Environment, Java运行时环境)如果你想运行一个已有的Java程序那么安装JRE就够了。它包含了JVM和运行Java程序所必需的核心类库比如java.lang,java.util等。JDK (Java Development Kit, Java开发工具包)如果你想开发Java程序就必须安装JDK。JDK JRE 开发工具。这些开发工具包括javac: Java编译器将.java源文件编译成.class字节码文件。jar: 打包工具用于创建和操作JAR文件。javadoc: 文档生成器。jdb: 调试器。以及其他监控、诊断工具如jps,jstack,jmap。一句话总结JDK是给开发者用的JRE是给程序最终用户用的。安装了JDK自然就包含了JRE和JVM。所以我们开发者的焦点永远是JDK。2.2 选择哪个JDK发行版如今Java世界不再是Oracle一家独大。自从Oracle调整了JDK的授权协议简单说就是商业用途可能收费后涌现出了多个优秀的开源免费发行版。对于个人开发者、学习和绝大多数公司内部使用我们完全可以选择这些免费的发行版。OpenJDK: 这是Java SE规范的开源参考实现是所有其他发行版的“源头”。它由Oracle和OpenJDK社区共同维护。Adoptium (原AdoptOpenJDK): 目前最受社区欢迎的发行版之一。由Eclipse基金会管理提供经过严格兼容性测试TCK的构建支持多种平台和版本包括最新的LTS长期支持版本。Amazon Corretto: 亚马逊提供的免费、多平台、生产就绪的OpenJDK发行版。亚马逊承诺长期支持并在其庞大的服务上得到验证稳定性和性能有保障。Azul Zulu: Azul Systems提供的免费OpenJDK发行版同样经过全面测试并提供商业支持选项。Oracle JDK: Oracle官方的发行版。对于个人学习、开发和非生产用途从JDK 17开始Oracle也提供了免费许可证。但为了省去潜在的授权疑虑很多团队更倾向于使用上述开源发行版。我的选择建议对于新手和大多数场景我强烈推荐从Adoptium或Amazon Corretto开始。它们下载方便、免费、社区支持好并且能无缝衔接后续的多版本管理工具。本文的演示也将以Adoptium的JDK为例。2.3 理解环境变量PATH与JAVA_HOME这是管理多个JDK版本的核心知识。JAVA_HOME: 这是一个指向特定JDK安装目录的环境变量。它的值应该类似于C:\Program Files\Eclipse Adoptium\jdk-17.0.58Windows或/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/HomemacOS。很多Java应用如Maven、Gradle、Tomcat、IDE以及我们自己的脚本都会读取JAVA_HOME这个变量来知道该使用哪个JDK。PATH: 这是操作系统用来查找可执行文件的路径列表。当你在命令行输入javac或java时系统会按照PATH中列出的目录顺序逐个查找名为javac.exe或java的文件。为了让系统能找到JDK的命令行工具我们需要将%JAVA_HOME%\binWindows或$JAVA_HOME/binmacOS/Linux添加到PATH变量中。关键逻辑当我们想切换JDK版本时最根本的操作就是修改JAVA_HOME环境变量的值使其指向另一个JDK的安装目录。PATH中指向bin目录的部分通常会随着JAVA_HOME的变化而自动生效如果配置正确的话。3. 单版本JDK的安装与验证我们先从最简单的场景开始在你的电脑上安装第一个JDK。这里以Windows系统安装Adoptium JDK 17为例macOS和Linux的步骤在思路上完全一致只是包管理器和路径有所不同。3.1 下载与安装访问下载页面打开浏览器访问 Adoptium官网 。选择版本在页面上你会看到多个版本选项。对于生产环境建议选择最新的LTS版本如JDK 17, JDK 21。LTS版本会获得更长时间的安全更新和支持。这里我们选择JDK 17。选择操作系统和架构根据你的电脑选择例如“Windows x64 Installer (.msi)”。对于macOS可以选择.pkg安装包对于Linux可以选择.tar.gz压缩包或通过包管理器安装。运行安装程序下载完成后双击.msi文件运行。安装路径安装程序会提示你选择安装路径。强烈建议使用默认路径例如C:\Program Files\Eclipse Adoptium\jdk-17.0.58。这能避免很多因路径包含空格或中文字符导致的奇怪问题也便于后续工具识别。设置JAVA_HOME大多数现代安装程序如Adoptium的.msi在安装过程中会提供一个选项询问是否“设置JAVA_HOME变量”或“添加到系统PATH”。请务必勾选这些选项。这是最省心、最不容易出错的方式。安装程序会自动帮你完成系统环境变量的配置。3.2 验证安装安装完成后我们需要验证JDK是否已正确安装并配置。打开命令行按下Win R输入cmd并回车打开命令提示符。或者使用更现代的终端如Windows Terminal或PowerShell。检查Java版本在命令行中输入以下命令并回车java -version如果配置正确你会看到类似下面的输出其中包含了版本号17.0.5、发行商信息Eclipse Adoptium等openjdk version 17.0.5 2022-10-18 OpenJDK Runtime Environment Temurin-17.0.58 (build 17.0.58) OpenJDK 64-Bit Server VM Temurin-17.0.58 (build 17.0.58, mixed mode, sharing)检查编译器再输入以下命令检查Java编译器javac -version输出应该类似于javac 17.0.5。如果这两个命令都能正确输出版本信息恭喜你第一个JDK已经成功安装并配置好了注意如果命令提示“不是内部或外部命令也不是可运行的程序”说明环境变量主要是PATH没有配置成功。此时可以回到安装程序重新运行修复或者需要手动配置环境变量我们会在下一节详细讲解手动配置方法。4. 手动配置环境变量备用方案虽然安装程序通常能自动配置但了解手动配置的方法至关重要尤其是在自动配置失败、或者你需要更精细地控制时。我们以Windows系统为例。4.1 找到JDK安装目录首先你需要知道JDK被安装在哪里。默认情况下Adoptium JDK通常安装在C:\Program Files\Eclipse Adoptium\下里面会有一个以jdk-开头的文件夹例如jdk-17.0.58。这个文件夹的完整路径就是你的JDK根目录。关键点我们需要的是这个JDK根目录下的bin目录的父目录也就是JDK的安装根目录。这个路径将被设为JAVA_HOME。4.2 设置JAVA_HOME系统变量在Windows搜索框输入“环境变量”选择“编辑系统环境变量”。在弹出的“系统属性”窗口中点击右下角的“环境变量(N)...”按钮。在“系统变量”区域这里设置的对所有用户生效点击“新建...”。在“变量名”中输入JAVA_HOME。在“变量值”中粘贴或输入你的JDK安装根目录路径例如C:\Program Files\Eclipse Adoptium\jdk-17.0.58。点击“确定”。4.3 更新PATH系统变量在“系统变量”区域找到名为Path的变量选中它然后点击“编辑...”。在打开的编辑窗口中点击“新建”。输入%JAVA_HOME%\bin。这里使用了%JAVA_HOME%来引用我们上一步设置的变量这是一个好习惯。这样以后你只需要修改JAVA_HOMEPATH就会自动更新。重要技巧为了确保系统优先使用我们设置的JDK最好将%JAVA_HOME%\bin这一项上移到列表的最顶端。因为系统会按顺序在PATH中查找命令如果列表前面有其他旧版本的Java路径可能会产生冲突。点击“确定”关闭所有窗口。4.4 验证手动配置打开一个新的命令提示符窗口必须新开窗口因为环境变量的更改只对新启动的进程生效再次运行java -version和javac -version。如果输出正确说明手动配置成功。为什么必须开新窗口环境变量是在进程启动时被加载到内存中的。你已经打开的终端窗口在配置更改前就启动了它内部持有的还是旧的环境变量副本。新开的窗口会从系统重新读取最新的配置。5. 多版本JDK的管理策略与工具当你需要安装第二个、第三个JDK时简单重复安装步骤会导致JAVA_HOME和PATH指向混乱。我们需要一套管理策略。主要有两种主流方式手动切换和使用版本管理工具。5.1 手动管理最基础但最透明手动管理意味着你需要自己维护多个JAVA_HOME的指向。具体做法是按照第3节的方法将不同版本的JDK安装到不同的目录。例如JDK 8:C:\Java\jdk1.8.0_351JDK 11:C:\Java\jdk-11.0.17JDK 17:C:\Program Files\Eclipse Adoptium\jdk-17.0.58当需要切换版本时手动去“系统属性” - “环境变量”中修改JAVA_HOME的值将其指向目标JDK的安装根目录。确保PATH变量中包含的是%JAVA_HOME%\bin。优点简单直接无需额外工具对理解环境变量工作原理有帮助。缺点繁琐、容易出错、切换不够灵活。不适合需要频繁切换版本的场景。5.2 使用专用版本管理工具强烈推荐这是现代Java开发者的标配。它们能让你在命令行中一键切换全局或当前终端会话的JDK版本。对于Windows用户推荐使用scoop或jabbascoop: 一个强大的Windows命令行安装器。安装scoop后通过scoop install openjdk17scoop install openjdk11即可安装多个版本并使用scoop reset openjdk11来切换默认版本。它自动帮你管理环境变量。jabba: 一个跨平台的Java版本管理工具灵感来自Node的nvm。命令如jabba install openjdk1.17jabba use openjdk1.11。对于macOS/Linux用户推荐使用jenv或SDKMAN!jenv: 轻量级的Java环境管理工具。它可以管理多个JDK并设置全局、本地针对特定项目目录或当前shell的Java版本。命令直观jenv add /path/to/jdk,jenv global 17,jenv local 11。SDKMAN!: 功能更强大的工具不仅能管理JDK还能管理Groovy, Scala, Maven, Gradle等众多JVM生态工具。命令如sdk install java 17.0.5-temsdk use java 11.0.17-tem。对于所有平台尤其是IDE用户IDE内置管理像 IntelliJ IDEA 或 Eclipse 这样的现代IDE它们都有自己的JDK配置界面。你可以在IDE的设置中添加多个JDK然后为每个项目单独指定使用哪个JDK版本。这是项目级版本管理最常用、最有效的方式因为它完全独立于系统环境变量不会影响其他项目或命令行。我的实操心得我个人的工作流是结合使用工具和IDE。我会用scoop(Windows) 或jenv(macOS) 在系统层面管理一个“默认”或“全局”的JDK版本用于命令行下的临时操作或全局工具如全局Maven。而对于具体的项目100%依赖IDE如IntelliJ IDEA的项目设置来指定JDK。这样既能保证命令行的灵活性又能确保每个项目环境的绝对纯净和隔离。6. 使用jEnv进行多版本JDK管理macOS/Linux实战为了让讲解更具体我们以在macOS上使用jenv为例展示如何使用工具优雅地管理多个JDK。Windows用户可以将此思路对应到scoop上。6.1 安装jEnv首先你需要一个包管理器。macOS上最常用的是Homebrew。如果你没有安装Homebrew可以访问其官网获取安装命令。打开终端执行以下命令安装jEnvbrew install jenv安装完成后需要将jEnv的初始化脚本添加到你的shell配置文件如~/.zshrc或~/.bash_profile中这样每次打开终端它都能生效。echo export PATH$HOME/.jenv/bin:$PATH ~/.zshrc echo eval $(jenv init -) ~/.zshrc然后执行source ~/.zshrc让配置立即生效或者直接关闭终端重新打开。6.2 安装多个JDK并添加到jEnv假设我们需要JDK 8、JDK 11和JDK 17。安装JDK你可以通过Homebrew直接安装Adoptium的各个版本也可以从官网下载.pkg或.tar.gz文件手动安装。这里演示用Homebrew安装# 安装Adoptium的JDK 8, 11, 17 brew install --cask temurin8 brew install --cask temurin11 brew install --cask temurin17安装后JDK通常位于/Library/Java/JavaVirtualMachines/目录下。将已安装的JDK添加到jEnv管理# 查找JDK的安装路径Homebrew安装的通常会自动在标准位置 # 添加JDK 8 jenv add /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home # 添加JDK 11 jenv add /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home # 添加JDK 17 jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home添加成功后运行jenv versions你会看到一个列表前面带*号的是当前激活的版本。6.3 使用jEnv切换版本jenv提供了三个层级的版本控制全局版本 (global)设置整个系统默认使用的JDK版本。jenv global 17.0 # 设置全局默认使用JDK 17执行后在任何新打开的终端中java -version都会显示17。本地版本 (local)为当前目录及其子目录设置特定的JDK版本。这非常适用于项目级管理。cd ~/projects/my-legacy-project jenv local 1.8 # 为此项目设置使用JDK 8jenv会在当前目录下创建一个名为.java-version的文件里面记录了版本号。以后进入这个目录jenv会自动切换到指定的版本。Shell会话版本 (shell)仅为当前这个终端会话设置JDK版本关闭终端后失效。jenv shell 11.0 # 仅在这个终端窗口中使用JDK 11切换的魔法原理jenv并没有真正修改系统的JAVA_HOME环境变量。它通过在PATH最前面插入一个指向其“垫片”shim目录的路径并动态地创建指向不同JDKbin目录下命令的符号链接来实现的。当你切换版本时它只是改变了这些符号链接的目标。7. 在IDE中配置多版本JDK以IntelliJ IDEA为例无论系统环境如何IDE内的配置才是项目开发的“真理之源”。我们看看如何在IntelliJ IDEA中管理多个JDK。打开项目结构设置打开IDEA进入File-Project Structure(快捷键CtrlAltShiftS)。添加JDK在左侧选择Platform Settings-SDKs。你会看到当前已配置的JDK列表。点击左上角的号选择Add JDK...。选择JDK安装目录在弹出的文件选择器中导航到你安装的JDK的根目录对于macOS是.jdk/Contents/Home对于Windows是类似C:\Program Files\Eclipse Adoptium\jdk-17.0.58的目录。选中后点击OK。重复添加用同样的方法将其它版本的JDK如JDK 8, JDK 11都添加进来。IDEA会自动识别版本。为项目指定JDK回到Project Structure窗口的Project Settings-Project页面。在Project SDK下拉框中为你当前的项目选择需要的JDK版本。在Project language level下拉框中选择与JDK版本对应的语言级别通常选相同版本即可。为模块指定JDK在Project Settings-Modules页面可以为项目中的不同模块指定不同的SDK这在多模块且模块间JDK要求不同的项目中很有用。配置完成后你在IDEA中运行、调试、编译项目使用的就是你在这里指定的JDK完全不受系统环境变量影响。这是管理项目依赖JDK最清晰、最可靠的方式。8. 常见问题与排查技巧实录即使按照步骤操作你也可能会遇到一些问题。下面是我在实际操作中遇到过的典型问题及解决方法。8.1 问题命令提示“不是内部或外部命令”现象在命令行输入java -version或javac时系统报错。排查思路检查安装首先确认JDK是否真的安装成功。去安装目录看看bin文件夹是否存在里面是否有java.exe和javac.exe。检查JAVA_HOME在命令行输入echo %JAVA_HOME%(Windows) 或echo $JAVA_HOME(macOS/Linux)。如果输出为空或路径错误说明JAVA_HOME变量未设置或设置错误。检查PATH输入echo %PATH%或echo $PATH查看输出的路径列表中是否包含%JAVA_HOME%\bin或$JAVA_HOME/bin。如果没有或者JAVA_HOME本身是错的PATH里的这个条目也就无效了。重启终端修改环境变量后一定要关闭所有旧的命令行窗口重新打开一个新的。8.2 问题版本号不对或切换不生效现象明明切换了版本但java -version显示的仍然是旧版本。排查思路检查PATH顺序在Windows上系统按PATH列表的顺序查找命令。如果PATH中在%JAVA_HOME%\bin之前还存在其他Java安装路径比如旧的JRE路径C:\Program Files (x86)\Common Files\Oracle\Java\javapath系统会优先使用那个路径下的java命令。解决方案在环境变量编辑器中将%JAVA_HOME%\bin上移到PATH列表的最顶端。检查终端类型在macOS/Linux上如果你用了jenv等工具确保你已经按照工具的要求正确初始化了shell即正确修改了~/.zshrc或~/.bash_profile并source了。使用绝对路径验证直接使用JDK安装目录下的完整路径来执行命令可以绕过环境变量问题。例如# Windows C:\Program Files\Eclipse Adoptium\jdk-17.0.58\bin\java -version # macOS /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java -version如果这样能输出正确版本那问题肯定出在环境变量或版本管理工具的配置上。8.3 问题IDE无法识别已安装的JDK现象在IDEA中添加SDK时找不到或无法选择已安装的JDK目录。排查思路权限问题确保你有权限读取JDK的安装目录。在macOS/Linux上有时需要sudo权限。目录选择错误一定要选择JDK的根目录即包含bin,lib,jmods等文件夹的目录而不是bin目录本身也不是JRE目录。损坏的安装尝试重新安装JDK。有时安装包下载不完整会导致文件缺失。IDEA缓存尝试重启IDEA或者点击File-Invalidate Caches and Restart...来清除缓存并重启。8.4 多版本管理工具冲突现象同时使用了多个版本管理工具如系统环境变量、jenv、sdkman导致行为不可预测。我的建议保持简单只用一套。对于命令行环境选择一款你喜欢的工具如jenv或sdkman并坚持使用它来管理“全局”和“本地”版本。对于项目开发完全依赖IDE的配置。尽量避免手动修改系统JAVA_HOME来切换版本这很容易造成混乱。如果你决定使用工具就让它全权负责把系统环境变量里的JAVA_HOME和PATH中关于Java的条目都清理干净或者只保留工具自动管理的那部分。管理多个JDK版本从表面看是个环境配置问题但往深了说它反映的是一个开发者对自身工作环境掌控能力的体现。一套清晰、可复现、隔离良好的环境配置能极大提升开发效率减少“在我机器上是好的”这类问题的发生。花一点时间把这些基础打牢后续在应对复杂的项目依赖、CI/CD流水线搭建时你会感谢现在这个认真配置环境的自己。
