1. 从“找不到JDK”说起为什么你的Java环境总出问题如果你刚开始接触Java开发或者刚换了一台新电脑那么“JDK安装配置”这个看似简单的任务很可能就是你遇到的第一个拦路虎。我见过太多新手包括几年前的我在安装完JDK后兴冲冲地打开命令行输入java -version结果却弹出一句冰冷的“不是内部或外部命令也不是可运行的程序”。那一刻的挫败感我至今记忆犹新。这个问题的根源十有八九出在“环境变量”上。很多人照着教程下载、安装却忽略了最后也是最关键的一步——配置。JDKJava Development Kit不仅仅是安装到你的C盘或D盘就完事了你需要告诉你的操作系统“嘿我装了个叫Java的工具它的命令比如java,javac放在这个路径下以后你找命令的时候记得也去这里看看。” 这个“告诉”的过程就是配置环境变量。所以这篇教程的目的不仅仅是让你把JDK装上更是要让你彻底理解从下载、安装到配置的每一个环节尤其是环境变量这个“魔鬼细节”。我会带你走一遍完整的流程涵盖Windows和macOS两大主流系统并解释清楚每一步背后的逻辑。当你下次再遇到“找不到JDK”时你不仅能解决它还能清楚地知道问题出在哪里。2. 战前准备下载正确的JDK版本在动手安装之前选对版本是成功的第一步。这里有几个关键选择直接决定了你后续开发的顺畅程度。2.1 选择JDK发行版Oracle、OpenJDK还是其他如今JDK的选择比过去丰富得多。主流的有Oracle JDK这是最“正统”的版本由Java的创始公司Oracle提供。在很长一段时间里它是企业级开发的首选。但需要注意的是从JDK 11开始Oracle对用于商业生产的Oracle JDK开始收取许可费用个人学习、开发测试仍免费。它的更新和支持周期相对明确。OpenJDK这是Java SE平台的开源参考实现。简单理解它是Java的“开源版本”。自JDK 11之后Oracle JDK和OpenJDK在功能上已经非常接近。现在包括Amazon、Microsoft、Azul等很多公司都基于OpenJDK源码构建了自己的发行版并提供长期支持LTS。对于绝大多数开发者尤其是个人和学习者选择一款由可靠厂商提供的OpenJDK发行版是更主流、更免费的选择。其他厂商发行版如Adoptium Temurin原AdoptOpenJDK现由Eclipse基金会管理社区认可度高、Amazon Corretto亚马逊提供承诺免费长期支持、Azul Zulu、Microsoft Build of OpenJDK等。它们都提供免费的LTS版本稳定性有保障。我的选择建议对于新手和个人项目我强烈推荐从Adoptium Temurin或Amazon Corretto开始。它们下载方便有直观的官网免费且支持良好能帮你避开潜在的许可风险。本教程后续演示将以 Adoptium Temurin 为例。2.2 确定版本号LTS还是最新特性版JDK版本迭代很快每半年会有一个新特性版本发布如JDK 21, 22, 23...。但并非每个版本都会获得长期支持。长期支持版本LTS如 JDK 8, 11, 17, 21 会获得数年的更新和维护是企业稳定环境的首选。对于学习/新项目建议直接选择最新的LTS版本目前是JDK 21或JDK 17。它们包含了现代Java的诸多优秀特性且能获得长期支持。对于维护旧项目则需要根据项目要求来选择可能是JDK 8或JDK 11。2.3 下载实操以Adoptium Temurin JDK 21为例打开官网访问 Adoptium.net 。选择版本在首页你会看到“Latest LTS Release”通常就是最新的LTS版本如JDK 21。点击它或者点击“Other versions”选择JDK 17等。选择操作系统和架构Operating System: 根据你的系统选择Windows, macOS, Linux等。Architecture: 现代电脑通常是x6464位。苹果M系列芯片的Mac则选择aarch64。Package Type: Windows下建议选择.msi安装包安装最省心也可以选.zip压缩包需要手动配置。macOS下选择.pkg安装包或.tar.gz压缩包。JVM Implementation: 保持默认的 “HotSpot” 即可。点击下载页面下方会出现下载按钮点击下载安装包到你的电脑。完成这一步你已经拿到了正确的“武器”。接下来就是把它部署到你的“系统”中。3. 安装与配置Windows与macOS双平台详解安装过程本身是向导式的很简单。真正的核心和差异点在于安装后的环境变量配置。我会分别详细说明。3.1 Windows平台安装与配置假设你下载的是.msi安装包。安装步骤双击运行下载的.msi文件。在安装向导中点击“Next”。在“Custom Setup”页面这里非常关键请记住或者直接修改你的“安装路径”。默认路径通常是C:\Program Files\Eclipse Adoptium\jdk-21.x.x.x-hotspot。我个人的习惯是安装到一个没有空格和中文的路径比如D:\DevTools\Java\jdk-21。这可以避免未来某些极端情况下因路径问题导致的诡异错误。继续点击“Next”直到安装完成。配置环境变量这是重中之重环境变量配置的本质是在系统的“全局设置”里添加两个东西JAVA_HOME指向你的JDK安装根目录。很多Java应用如Maven, Gradle, Tomcat, IDE都依赖这个变量来定位Java。Path将JDK的bin目录添加进去。bin目录里存放了java,javac,jar等可执行命令。将它的路径加入Path系统才能在任意命令行位置识别这些命令。详细配置过程打开系统属性在Windows搜索框输入“环境变量”选择“编辑系统环境变量”。新建 JAVA_HOME在“系统变量”区域点击“新建...”。变量名输入JAVA_HOME。变量值输入你的JDK安装路径例如D:\DevTools\Java\jdk-21。务必确保这个路径真实存在且指向的是JDK根目录包含bin, lib, jre等文件夹的目录。点击“确定”。编辑 Path 变量在“系统变量”列表中找到Path变量选中并点击“编辑...”。在弹出的窗口中点击“新建”然后添加一条新记录%JAVA_HOME%\bin。这里使用%JAVA_HOME%是引用我们上一步创建的变量。这样做的好处是如果你将来升级JDK只需要修改JAVA_HOME这一个变量的值Path会自动生效无需再改。点击“确定”保存。为了确保旧的命令行窗口能读取到新的环境变量建议将所有打开的“命令提示符”或“PowerShell”窗口关闭再重新打开。验证安装打开新的“命令提示符”或“PowerShell”。输入以下命令并回车java -version如果配置成功你会看到类似下面的输出显示了Java的版本信息openjdk version 21.0.2 2024-01-16 LTS OpenJDK Runtime Environment Temurin-21.0.213 (build 21.0.213-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.213 (build 21.0.213-LTS, mixed mode, sharing)再输入javac -version这会显示Java编译器的版本输出类似javac 21.0.2。如果两个命令都能正确显示版本号恭喜你Windows下的JDK安装与配置大功告成3.2 macOS平台安装与配置在macOS上情况略有不同。如果你下载的是.pkg安装包安装过程会自动为你配置一部分环境但为了更灵活的管理尤其是管理多个JDK版本我们通常还是需要手动配置一下。安装步骤双击下载的.pkg文件。跟随安装向导点击“继续”、“同意”、“安装”输入你的管理员密码。安装完成后JDK通常会被安装到/Library/Java/JavaVirtualMachines/目录下例如路径可能是/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home。配置环境变量通过Shell配置文件macOS以及Linux使用Shell如bash或zsh作为命令行环境。我们需要修改Shell的配置文件如~/.zshrc或~/.bash_profile来设置环境变量。确定你的Shell和配置文件打开“终端”应用。输入echo $SHELL查看当前Shell。如果输出/bin/zsh说明你在用zshmacOS Catalina及以后版本的默认Shell配置文件是~/.zshrc。如果输出/bin/bash配置文件是~/.bash_profile。编辑配置文件使用文本编辑器如nano, vim或VS Code打开对应的文件。这里以zsh为例# 使用nano编辑器打开 nano ~/.zshrc或者用VS Codecode ~/.zshrc添加环境变量在配置文件的末尾添加以下几行# 设置JAVA_HOME路径请替换为你实际的JDK Home路径 export JAVA_HOME/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home # 将JAVA_HOME的bin目录加入PATH export PATH$JAVA_HOME/bin:$PATHexport命令用于设置环境变量。$JAVA_HOME/bin:$PATH的意思是新的PATH变量由$JAVA_HOME/bin和原来的$PATH连接而成且$JAVA_HOME/bin在前。这保证了系统会优先使用我们设置的JDK命令。保存并生效如果使用nano按CtrlX然后按Y确认保存再按回车确认文件名。保存后需要让配置文件立即生效执行source ~/.zshrc或者直接关闭终端重新打开一个新窗口。验证安装和Windows一样在新终端中执行java -version和javac -version确认版本信息正确输出。macOS上的一个便捷工具/usr/libexec/java_homemacOS系统提供了一个很实用的命令usr/libexec/java_home。它可以帮你找到已安装的JDK路径。你可以通过$(/usr/libexec/java_home)来动态设置JAVA_HOME这在管理多个JDK版本时特别有用。例如可以在.zshrc中写export JAVA_HOME$(/usr/libexec/java_home -v 21)来指定使用版本21的JDK。4. 进阶管理多版本JDK共存与切换在实际开发中你很可能需要同时维护基于不同Java版本的项目。比如老项目用JDK 8新项目用JDK 21。这就需要管理多个JDK版本并能轻松切换。4.1 多版本共存的原理多版本共存的核心在于JAVA_HOME环境变量。系统通过JAVA_HOME来确定当前使用哪个JDK。Path中的%JAVA_HOME%\bin或$JAVA_HOME/bin则让系统能找到对应的命令。因此切换版本的本质就是修改JAVA_HOME的值使其指向另一个JDK的安装目录。4.2 Windows下的多版本管理手动/脚本在Windows上没有macOS那样内置的java_home工具但我们可以通过一些手动或脚本化的方式来实现。方法一手动修改环境变量最直接直接进入“系统属性” - “环境变量”修改JAVA_HOME的值指向另一个JDK的路径。然后必须新开一个命令行窗口新的设置才会生效。这种方法简单粗暴但切换频繁时会很麻烦。方法二使用批处理脚本.bat你可以为每个JDK版本创建一个简单的批处理脚本。创建一个文本文件命名为use-jdk21.bat内容如下echo off setx JAVA_HOME D:\DevTools\Java\jdk-21 echo JAVA_HOME has been set to JDK 21. Please restart your command prompt.再创建一个use-jdk17.bat内容指向JDK 17的路径。当需要切换时以管理员身份运行对应的.bat脚本。setx命令会永久修改系统环境变量。运行后需要关闭所有命令行窗口再重新打开。注意setx是永久修改会影响所有后续打开的程序。如果你只想在当前命令行窗口临时切换应该使用set命令如set JAVA_HOMED:\...但这不会改变Path中基于%JAVA_HOME%的部分可能需要同时手动将Path中的JDKbin路径前置。方法三使用第三方工具对于追求效率的Windows开发者可以考虑使用像sdkman需要通过WSL或Cygwin或者JEnv的Windows端口等工具它们提供了类似macOS/Unix下的版本管理体验。4.3 macOS/Linux下的优雅方案jEnv或手动Shell配置在类Unix系统上管理多版本JDK要优雅得多。方法一使用 jEnv推荐jEnv 是一个轻量级的命令行工具专门用于管理JAVA_HOME。安装jEnv使用Homebrewbrew install jenv将jEnv集成到你的Shell根据你的Shell将初始化语句添加到配置文件如~/.zshrc末尾# 对于bash echo export PATH$HOME/.jenv/bin:$PATH ~/.bash_profile echo eval $(jenv init -) ~/.bash_profile # 对于zsh echo export PATH$HOME/.jenv/bin:$PATH ~/.zshrc echo eval $(jenv init -) ~/.zshrc然后执行source ~/.zshrc。添加已安装的JDK# 添加JDK路径可以通过 /usr/libexec/java_home -V 查看 jenv add /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home查看和管理版本jenv versions # 查看所有已管理的版本 jenv global 21 # 设置全局默认版本为21 jenv local 17 # 在当前目录下设置本地版本为17会创建.jenv-version文件 jenv shell 11 # 在当前Shell会话中临时使用版本11jEnv通过创建垫片shim来覆盖java,javac等命令根据你设置的上下文全局、本地、Shell自动切换JAVA_HOME非常方便。方法二手动Shell函数/别名如果你不想安装额外工具可以在Shell配置文件中编写函数来快速切换。在~/.zshrc中添加function jdk() { version$1 export JAVA_HOME$(/usr/libexec/java_home -v $version) echo JAVA_HOME is set to $JAVA_HOME java -version }然后执行source ~/.zshrc。之后在终端里输入jdk 21或jdk 17就可以快速切换了。这个函数利用了macOS自带的java_home命令来查找对应版本的路径。5. 集成开发环境IDE中的JDK配置即使命令行配置正确你的IDE如IntelliJ IDEA, Eclipse, VS Code也可能需要单独配置项目或全局的JDK。这是因为IDE有自己独立的配置体系不一定完全依赖系统的JAVA_HOME。5.1 IntelliJ IDEA 中的配置IDEA对JDK的管理非常直观。配置SDK全局JDK打开File - Project Structure...(CtrlAltShiftS)。在左侧选择Platform Settings - SDKs。点击左上角的号选择Add JDK...。在弹出的文件选择器中导航到你的JDK安装根目录例如D:\DevTools\Java\jdk-21或/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home选中后点击“OK”。IDEA会自动识别JDK版本并命名。你可以在这里添加多个不同版本的JDK。为项目指定SDK在同一个Project Structure窗口中选择Project Settings - Project。在Project SDK下拉框中选择你刚才添加的或者项目中需要的JDK版本。在Project language level下拉框中通常选择与SDK版本对应的语言级别如SDK是21语言级别选21。为模块指定SDK如果项目是多模块的在Project Settings - Modules下选中具体模块在右侧的Dependencies标签页中可以查看和修改该模块使用的SDK。IDEA的贴心之处当你打开一个Maven或Gradle项目时IDEA通常会根据构建工具如pom.xml中的maven.compiler.source的配置自动为你配置项目SDK和语言级别。如果自动配置失败再手动按上述步骤检查即可。5.2 Visual Studio Code 中的配置VS Code通过Java扩展包来支持Java开发JDK配置主要在用户或工作区设置中进行。安装扩展确保安装了“Extension Pack for Java”这个扩展包。配置JDK路径按下CtrlShiftP(Windows/Linux) 或CmdShiftP(macOS) 打开命令面板。输入Java: Configure Java Runtime并执行。这会打开一个专门的界面显示VS Code检测到的所有JDK。你可以点击“Add JDK...”来手动添加新的JDK路径。你也可以直接编辑用户设置settings.json。添加或修改如下配置java.jdt.ls.java.home: D:\\DevTools\\Java\\jdk-21, // Windows路径示例 // 或 java.jdt.ls.java.home: /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home, // macOS路径示例java.jdt.ls.java.home这个设置指定了Java语言服务器使用的JDK它用于提供代码智能感知、编译等核心功能。项目特定JDK你还可以在工作区设置.vscode/settings.json中覆盖上述配置为特定项目指定不同的JDK。一个常见的坑即使系统环境变量和VS Code的java.home配置正确如果你在VS Code中打开了一个Maven项目项目本身可能通过pom.xml指定了编译器版本。此时VS Code的Java扩展会优先使用Maven配置的编译器版本来编译和运行代码。因此如果遇到版本不一致的问题需要同时检查这几个地方。5.3 Eclipse 中的配置Eclipse使用“已安装的JRE”这个概念来管理Java运行环境。添加已安装的JRE打开Window - Preferences。导航到Java - Installed JREs。点击Add...选择Standard VM点击Next。在JRE home字段点击Directory...然后选择你的JDK安装根目录注意是包含bin和lib的根目录不是bin目录本身。Eclipse会自动填充其他信息。给它起个名字如“JDK-21-Temurin”点击Finish。为项目指定JRE右键点击项目 -Properties。选择Java Build Path切换到Libraries标签页。选中当前的JRE System Library点击Edit...。选择Workspace default JRE或Alternate JRE然后在下拉框中选择你刚刚添加的JRE。配置好IDE的JDK后IDE内的编译、运行和调试就会使用你指定的版本这通常比系统环境变量优先级更高也为多版本项目管理提供了便利。
