1. 项目概述为什么JDK是开发者的第一块基石如果你刚接触编程或者准备从Python、前端转向Java后端开发那么安装和配置JDKJava Development Kit就是你绕不开的第一步。这听起来像是个简单的“下载-安装-点下一步”的过程但很多新手甚至一些有经验的开发者都在这里踩过坑。比如明明安装了JDK命令行却死活提示“不是内部或外部命令”或者项目需要JDK 11但系统里装的却是JDK 8导致各种兼容性问题。更头疼的是直接从Oracle官网下载可能会遇到网速慢、需要注册账号甚至旧版本难以寻觅的窘境。所以这篇内容的目的就是帮你把这块基石铺得又平又稳。我会带你走一遍从选择版本、寻找可靠下载源到安装、配置环境变量再到最后验证的完整流程。不止是告诉你点击哪里更重要的是解释清楚每一步背后的逻辑为什么环境变量要那样配不同的JDK提供商如Oracle JDK、OpenJDK有什么区别如何管理多个JDK版本这些才是让你真正掌握这个技能并能举一反三解决未来环境配置问题的关键。无论你是计算机专业的学生还是准备转行的新人跟着这篇指南操作都能在10分钟内拥有一个可用的Java开发环境。2. JDK核心概念与版本选择策略在动手下载之前我们必须先搞清楚几个关键概念这直接决定了后续所有步骤的选择。2.1 JDK、JRE与JVM三者的关系与区别很多人会混淆这三个名词简单来说JVM (Java Virtual Machine)Java虚拟机。它是Java程序运行的“发动机”负责执行编译后的字节码.class文件。它实现了Java“一次编写到处运行”的核心特性。你无法单独安装JVM。JRE (Java Runtime Environment)Java运行时环境。它 JVM 运行Java程序所必需的核心类库。如果你只想运行别人写好的Java程序比如用Java开发的桌面软件安装JRE就足够了。JDK (Java Development Kit)Java开发工具包。它 JRE 开发工具如编译器javac、调试器jdb、打包工具jar等。你要做开发就必须安装JDK。安装了JDK自然就包含了JRE和JVM。注意从JDK 11开始Oracle的官方版本不再提供独立的JRE安装包。因为模块化之后你可以用JDK来自定义生成一个更小的JRE。但对于绝大多数开发者直接安装完整的JDK是最省事的选择。2.2 主流JDK发行版解析Oracle JDK vs OpenJDK这是选择版本时最大的分水岭。历史上Oracle JDK是官方正统但授权协议曾发生过重大变化。OpenJDK这是Java SE标准版的官方开源参考实现。你可以把它理解为Java的“源代码”和“标准答案”。它的许可证是GPLv2CPE对个人和商业使用都非常友好没有付费要求。现在包括Oracle在内的许多公司都基于OpenJDK源码构建自己的发行版。Oracle JDK这是Oracle公司基于OpenJDK源码构建的发行版。在JDK 8时代它对于商业用途需要付费许可。但从JDK 17开始情况又变了Oracle JDK 17及以后的版本在开源GPLv2协议下也提供了免费版本但如果你需要Oracle提供的商业支持和长期更新服务则需要付费订阅。对于绝大多数个人开发者、学生和学习者我的建议是优先选择其他厂商提供的OpenJDK发行版或者直接使用Oracle的免费OpenJDK构建版本。原因如下完全免费无需担心任何潜在的许可费用问题。功能一致在核心功能上与Oracle JDK几乎无差别。获取方便下载渠道多速度往往更快。2.3 如何选择JDK版本LTS与最新特性版的权衡Java版本迭代很快每半年发布一个特性版本。但不是每个版本都会获得长期支持。LTS (Long-Term Support) 长期支持版这些版本会获得数年的更新支持包括安全更新和错误修复是企业级应用和追求稳定性的项目的首选。目前主流的LTS版本有JDK 8经典、JDK 11、JDK 17、JDK 21。JDK 17是目前被广泛认为可以替代JDK 8的新一代LTS基准。非LTS版特性版每半年发布一次如JDK 18, 19, 20, 22, 23。它们只提供约6个月的支持主要用于体验最新语言特性和API。不适合用于生产环境。选择策略新手学习/学校课程优先确认你的教程或教材使用的版本。如果未指定选择JDK 17或JDK 21这两个较新的LTS版本是安全且现代的起点。企业开发/已有项目严格遵循项目要求。老项目可能锁定在JDK 8或11。个人新项目建议从JDK 21开始它是目前最新的LTS包含了Records、Pattern Matching、虚拟线程等大量现代特性。2.4 可靠的JDK下载镜像源推荐鉴于直接从Oracle官网下载可能较慢或需要登录这里推荐几个国内开发者常用的镜像源以下载OpenJDK发行版为主Adoptium (Eclipse Temurin)目前最受社区欢迎的免费OpenJDK发行版之一。由Eclipse基金会管理提供清晰的LTS和最新版本下载支持多种操作系统和架构。国内访问速度不错。官网adoptium.net/zh-CN微软OpenJDK微软维护的OpenJDK发行版质量可靠下载直接。官网learn.microsoft.com/zh-cn/java/openjdkAzul ZuluAzul Systems提供的OpenJDK发行版社区版免费同样提供长期支持。官网www.azul.com/downloads华为云镜像站提供了包括OpenJDK在内的多种开源软件镜像国内下载速度极快。地址mirrors.huaweicloud.com清华大学开源软件镜像站国内老牌镜像站软件齐全。地址mirrors.tuna.tsinghua.edu.cn实操心得对于国内用户我强烈推荐将Adoptium (Temurin)作为首选。它的网站界面友好版本分类清晰HotSpot JVM并且提供了直接的.msiWindows或.pkgmacOS安装包比解压压缩包配置起来更省心。如果追求极速下载可以去华为云或清华镜像站找到对应的版本压缩包。3. 手把手安装Windows/macOS/Linux全平台指南下面我将分平台演示安装过程。我们以在Windows和macOS上安装Adoptium JDK 21 (Temurin)为例Linux会给出通用命令。3.1 Windows平台安装详解Windows用户通常有两种选择安装程序.msi或压缩包.zip。前者会自动处理一些配置后者更灵活。步骤一下载安装程序访问adoptium.net/zh-CN。在首页选择版本如Temurin 21 (LTS)点击“下载”。在详情页选择操作系统Windows、架构x64除非你是ARM电脑、包类型Installer (.msi)然后点击最大的下载按钮。步骤二运行安装向导双击下载的.msi文件。在安装向导中点击“Next”。关键步骤设置安装路径。默认路径通常是C:\Program Files\Eclipse Adoptium\jdk-21.0.x.x-hotspot。我建议保持默认或者改到一个没有中文和空格的路径例如D:\DevTools\jdk-21。记住这个路径等下配置环境变量要用。接下来的选项如是否创建开始菜单文件夹可以按需选择。点击“Install”完成安装。步骤三验证安装初步安装完成后可以打开一个新的命令提示符CMD或 PowerShell输入java -version如果安装程序已经自动配置了部分环境变量你可能会看到类似下面的输出openjdk version 21.0.3 2024-10-15 LTS OpenJDK Runtime Environment Temurin-21.0.39 (build 21.0.39-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.39 (build 21.0.39-LTS, mixed mode, sharing)这说明JRE运行环境的路径已经被识别。但这并不代表JDK开发工具配置好了我们还需要检查编译器javac -version如果这个命令报错“不是内部或外部命令”那就说明我们还需要手动配置JAVA_HOME和Path环境变量。即使javac能用为了后续开发工具如Maven、Gradle能正确找到JDK手动配置JAVA_HOME也是一个好习惯。3.2 macOS平台安装详解macOS的安装体验通常更流畅通过.pkg安装包或Homebrew都可以。方法A使用.pkg安装包推荐新手在Adoptium网站选择macOS、架构Apple Silicon选aarch64Intel选x64、包类型Installer (.pkg)。下载后双击.pkg文件按提示一步步安装即可。安装程序会自动将JDK部署到系统标准目录/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home。安装后打开终端Terminal输入java -version和javac -version验证。通常.pkg安装后会自动配置两个命令都应成功。方法B使用Homebrew推荐开发者如果你已经安装了HomebrewmacOS包管理器安装JDK只是一条命令的事# 安装Eclipse Temurin的JDK 21 brew install --cask temurin21 # 或者安装Azul Zulu的JDK 21 brew install --cask zulu21安装后同样在终端验证。Homebrew会自动处理好路径链接。注意事项macOS可能会在系统更新后或者当你安装了多个JDK时出现版本混乱。你可以使用/usr/libexec/java_home -V命令查看所有已安装的JDK及其路径。如果需要切换版本可以通过设置JAVA_HOME环境变量来实现例如在~/.zshrc文件中添加export JAVA_HOME$(/usr/libexec/java_home -v 21)来指定使用JDK 21。3.3 Linux平台安装详解以Ubuntu为例Linux系统通常通过包管理器或解压压缩包来安装。方法A使用APT包管理器Ubuntu/Debian一些OpenJDK发行版提供了PPA软件源。对于Adoptium/Temurin可以按以下步骤# 1. 安装必要的工具 sudo apt update sudo apt install -y wget apt-transport-https # 2. 导入Adoptium的GPG密钥和仓库 wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /etc/apt/keyrings/adoptium.asc echo deb [signed-by/etc/apt/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(awk -F /^VERSION_CODENAME/{print$2} /etc/os-release) main | sudo tee /etc/apt/sources.list.d/adoptium.list # 3. 更新源并安装JDK 21 sudo apt update sudo apt install -y temurin-21-jdk # 4. 验证安装 java -version javac -version方法B手动下载.tar.gz压缩包这种方式更通用适用于所有Linux发行版。从Adoptium网站下载Linux的.tar.gz包例如x64架构。在终端中执行以下命令假设下载文件在~/Downloads# 1. 创建目标目录可选通常放在/usr/lib或/opt下 sudo mkdir -p /usr/lib/jvm # 2. 解压到目标目录 sudo tar -xzf ~/Downloads/OpenJDK21U-jdk_x64_linux_hotspot_21.0.3_9.tar.gz -C /usr/lib/jvm/ # 3. 重命名目录以便管理可选 cd /usr/lib/jvm sudo mv jdk-21.0.39 temurin-21 # 4. 接下来需要手动配置环境变量见下一章节4. 环境变量配置让系统认识你的JDK环境变量是操作系统用来存储全局配置信息的地方。配置JDK环境变量本质上就是告诉系统“我的JDK安装在哪里请让所有程序都能找到它。”4.1 核心环境变量JAVA_HOME与PATHJAVA_HOME这个变量指向你的JDK安装的根目录。很多Java开发工具如Maven、Gradle、Tomcat、IDE都依赖这个变量来定位JDK。它的值应该是像C:\Program Files\Eclipse Adoptium\jdk-21.0.x.x-hotspot或/usr/lib/jvm/temurin-21这样的路径。Path这是系统用来查找可执行文件的路径列表。当你在命令行输入javac时系统会遍历Path中的每一个目录寻找名为javac.exeWindows或javacmacOS/Linux的文件。我们需要将JDK的bin目录%JAVA_HOME%\bin或$JAVA_HOME/bin添加到Path中这样系统就能找到java,javac,jar等命令。为什么一定要配JAVA_HOME而不只是把bin目录加到Path标准化约定几乎所有Java生态工具都认JAVA_HOME。便于管理当你需要切换JDK版本时只需修改JAVA_HOME这一个变量的值所有依赖它的工具都会自动切换无需改动Path中复杂的条目。路径引用在脚本或配置文件中使用%JAVA_HOME%或$JAVA_HOME来引用路径比写死绝对路径更灵活、可移植。4.2 Windows系统环境变量配置图形化界面打开环境变量设置右键点击“此电脑”或“我的电脑”选择“属性”。点击“高级系统设置”。在弹出的“系统属性”窗口中点击右下角的“环境变量(N)...”按钮。新建JAVA_HOME系统变量在下面的“系统变量(S)”区域点击“新建...”。变量名JAVA_HOME变量值你的JDK安装路径例如C:\Program Files\Eclipse Adoptium\jdk-21.0.3.9-hotspot。关键技巧不要包含bin目录JAVA_HOME指向的是包含bin,lib,jmods等文件夹的根目录。一个快速验证方法是打开这个路径应该能看到bin文件夹在里面。编辑Path变量在“系统变量”列表中找到Path变量选中并点击“编辑”。在打开的编辑窗口中点击“新建”。添加一个新条目%JAVA_HOME%\bin重要顺序确保%JAVA_HOME%\bin这一条在列表中的位置相对靠前。因为如果有多个Java路径比如旧的JRE系统会使用Path中先找到的那个。你可以使用“上移”按钮将其移到顶部附近。验证配置关闭所有已打开的命令提示符窗口环境变量需要重启终端才能生效。打开一个新的命令提示符CMD或 PowerShell。依次输入以下命令echo %JAVA_HOME%这应该正确显示你设置的路径。java -version javac -version这两个命令都应该成功输出版本信息且版本号与你安装的一致。4.3 macOS/Linux系统环境变量配置Shell配置文件在macOS和Linux中环境变量通常在用户的家目录下的shell配置文件中设置。常见的shell是bash或zsh。确定你的Shell和配置文件打开终端。输入echo $SHELL查看当前shell。/bin/zsh表示zsh/bin/bash表示bash。zsh的配置文件是~/.zshrc。bash的配置文件是~/.bash_profile或~/.bashrc对于登录shell通常用.bash_profile。编辑配置文件以zsh为例# 使用文本编辑器如nano或vim打开配置文件 nano ~/.zshrc在文件的末尾添加以下几行# 设置JAVA_HOME请将路径替换为你的实际JDK路径 # 对于通过.pkg安装的Temurin路径通常是 export JAVA_HOME/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home # 如果你是通过Homebrew安装的路径可能类似 # export JAVA_HOME$(/usr/libexec/java_home -v 21) # 将JAVA_HOME的bin目录添加到PATH export PATH$JAVA_HOME/bin:$PATH注意$PATH前面的$JAVA_HOME/bin:表示将新路径添加到现有PATH的最前面。冒号:是Linux/macOS中路径的分隔符。使配置生效保存并关闭编辑器在nano中按CtrlX然后按Y再按回车。在终端中执行以下命令让配置文件立即生效source ~/.zshrc如果你修改的是.bash_profile则用source ~/.bash_profile验证配置echo $JAVA_HOME java -version javac -version4.4 验证配置成功的完整流程配置完成后不要只满足于java -version能运行。执行一个完整的“编译-运行”流程才是终极验证。创建一个简单的Java文件。在任意位置比如桌面新建一个文本文件命名为HelloWorld.java。用记事本或任何代码编辑器打开输入以下经典代码public class HelloWorld { public static void main(String[] args) { System.out.println(Hello, World! JDK环境配置成功); } }注意文件名HelloWorld.java必须与类名HelloWorld完全一致包括大小写。打开命令行终端导航到该文件所在目录。Windows:cd C:\Users\YourName\DesktopmacOS/Linux:cd ~/Desktop编译Java源文件javac HelloWorld.java如果成功不会有任何输出但目录下会生成一个HelloWorld.class文件。运行编译后的类文件java HelloWorld注意这里运行的是类名HelloWorld不是文件名HelloWorld.class。如果终端成功打印出Hello, World! JDK环境配置成功那么恭喜你你的JDK开发环境已经100%就绪。5. 多版本JDK管理与切换实战在实际开发中你很可能需要同时维护多个项目它们可能要求不同的JDK版本。学会管理多个JDK是一项必备技能。5.1 Windows下的多版本管理Windows没有内置的版本管理工具但我们可以通过灵活配置环境变量来实现。方法手动切换JAVA_HOME这是最直接的方法。你只需要安装多个版本的JDK到不同的目录然后在需要的时候去系统环境变量里修改JAVA_HOME的值指向对应的版本目录并确保Path中的%JAVA_HOME%\bin生效通常需要重启终端或电脑。更优雅的工具使用第三方版本管理器jEnv这是一个命令行工具虽然源自Unix但也有Windows版本如jenv-win。它可以让你轻松地在多个JDK版本间切换。IDE管理像IntelliJ IDEA、Eclipse这样的集成开发环境可以在项目级别或全局级别指定JDK无需修改系统环境变量。这是最常用的方式。5.2 macOS/Linux下的多版本管理Unix-like系统有更成熟的命令行工具。1. 使用jenv(推荐)jenv是一个轻量级的命令行工具可以设置全局、目录项目或shell会话级别的JDK版本。# 安装jenv (macOS使用Homebrew) brew install jenv # 将jenv初始化脚本添加到shell配置中 echo export PATH$HOME/.jenv/bin:$PATH ~/.zshrc echo eval $(jenv init -) ~/.zshrc source ~/.zshrc # 添加已安装的JDK到jenv管理 jenv add /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home jenv add /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home # 查看所有被管理的版本 jenv versions # 设置全局默认版本 jenv global 11 # 为当前shell会话设置版本 jenv shell 17 # 为特定目录项目设置本地版本会在目录下生成.jen-version文件 cd ~/my-java8-project jenv local 1.82. 使用update-alternatives(Linux, 如Ubuntu)这是Debian/Ubuntu系统自带的工具用于管理同一个命令的多个备选方案。# 假设你已经手动安装了两个JDK在 /usr/lib/jvm/ 下 # 注册JDK sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/temurin-11/bin/java 1100 sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/temurin-11/bin/javac 1100 sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/temurin-17/bin/java 1700 sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/temurin-17/bin/javac 1700 # 交互式选择默认版本 sudo update-alternatives --config java sudo update-alternatives --config javac5.3 在IDE中配置JDK以IntelliJ IDEA为例这是日常开发中最实用的方式。你可以在IDE中配置多个JDK并为每个项目指定一个。打开IntelliJ IDEA进入File-Project Structure(Windows/Linux) 或IntelliJ IDEA-Preferences-Build, Execution, Deployment-Build Tools-Project Structure(macOS)。在Project Structure窗口的左侧选择Platform Settings-SDKs。点击左上角的号选择Add JDK...。在弹出的文件选择器中导航到你的JDK安装根目录即JAVA_HOME指向的目录选中后点击OK。你可以重复此步骤添加多个版本的JDK。在Project Settings-Project中可以为当前项目选择Project SDK。在Project Settings-Modules中可以为每个模块单独指定SDK。这样你的系统环境变量可以保持稳定比如一直指向JDK 17而不同的IDEA项目则可以自由使用JDK 8、11或21互不干扰。6. 常见问题排查与深度解决方案即使按照步骤操作你也可能会遇到一些问题。这里汇总了最常见的坑和解决办法。6.1 问题速查表问题现象可能原因解决方案‘java’ 不是内部或外部命令1. JDK未安装。2.JAVA_HOME未设置或设置错误。3.%JAVA_HOME%\bin未添加到Path或Path修改未生效。1. 确认已安装JDK。2. 检查JAVA_HOME变量值是否为JDK根目录有bin文件夹。3. 检查Path重启命令行或电脑。‘javac’ 不是内部或外部命令JAVA_HOME指向了JRE目录而不是JDK目录。确保JAVA_HOME指向的是JDK安装目录包含javac.exe的父目录的父目录。java -version与javac -version版本不一致系统Path中存在多个Java路径且顺序有误。调整Path环境变量将%JAVA_HOME%\bin移至最前面。或检查是否有其他Java如JRE被优先调用。命令行生效但IDE如IDEA报错找不到JDKIDE未正确配置项目SDK或使用了独立的内部配置。在IDE的项目结构设置中手动添加并指定正确的JDK路径。安装后需要同意许可协议Oracle旧版下载的是Oracle JDK 8等旧版本安装过程需要点击接受许可。仔细阅读安装向导勾选接受许可协议的选项。或考虑换用OpenJDK发行版。在macOS上即使配置了JAVA_HOME某些脚本仍报错某些脚本或工具可能硬编码调用了/usr/libexec/java_home或系统默认Java。使用sudo ln -sfn $(JAVA_HOME) /Library/Java/JavaVirtualMachines/current.jdk创建一个软链接或者确保你的JAVA_HOME是通过/usr/libexec/java_home -v命令可以查询到的。6.2 深度排查技巧技巧一检查命令的完整路径当命令不执行时在终端使用whichmacOS/Linux或whereWindows命令查看系统实际调用了哪个程序。Windows:where javawhere javacmacOS/Linux:which javawhich javac这会输出命令所在的实际路径。如果路径不是你新配置的JDK的bin目录就说明环境变量没生效或者被覆盖了。技巧二在命令行中临时设置环境变量用于测试如果你不想重启终端或修改配置文件可以临时设置Windows (CMD):set JAVA_HOMEC:\你的\JDK\路径然后set Path%JAVA_HOME%\bin;%Path%Windows (PowerShell):$env:JAVA_HOME C:\你的\JDK\路径然后$env:Path $env:JAVA_HOME\bin; $env:PathmacOS/Linux:export JAVA_HOME/你的/JDK/路径然后export PATH$JAVA_HOME/bin:$PATH这样设置只对当前这个命令行窗口有效。关闭后失效。这是一个非常好的测试手段可以先验证路径是否正确再写入永久配置。技巧三处理Windows用户变量与系统变量的冲突Windows有“用户变量”和“系统变量”。如果同一个变量如JAVA_HOME在两个地方都定义了那么当前用户登录时“用户变量”会覆盖“系统变量”。检查时两个地方都要看避免重复或冲突。技巧四警惕安装程序自动添加的路径一些JDK安装程序尤其是Windows的.msi会自动在Path的开头添加一个指向其bin目录的绝对路径如C:\Program Files\Common Files\Oracle\Java\javapath。这个路径可能指向一个JRE或旧版本。当你手动配置了%JAVA_HOME%\bin后由于这个自动添加的路径在前系统会优先使用它。解决办法是在Path变量中找到并删除这个自动添加的条目或者确保你的%JAVA_HOME%\bin在它前面。6.3 关于镜像网站与下载加速如果你从主站下载速度慢可以尝试使用国内镜像站。例如在华为云镜像站你可以找到openjdk目录里面通常有Adoptium/Temurin的归档。下载时注意选择正确的操作系统、架构和文件类型如tar.gz,msi,pkg。对于其他开发环境配置如Maven、Node.js同理也可以寻找对应的镜像源来加速下载例如将Maven的settings.xml中的仓库地址改为阿里云镜像。这能极大提升环境搭建的效率。 JDK安装配置全攻略：从核心概念到多版本管理
1. 项目概述为什么JDK是开发者的第一块基石如果你刚接触编程或者准备从Python、前端转向Java后端开发那么安装和配置JDKJava Development Kit就是你绕不开的第一步。这听起来像是个简单的“下载-安装-点下一步”的过程但很多新手甚至一些有经验的开发者都在这里踩过坑。比如明明安装了JDK命令行却死活提示“不是内部或外部命令”或者项目需要JDK 11但系统里装的却是JDK 8导致各种兼容性问题。更头疼的是直接从Oracle官网下载可能会遇到网速慢、需要注册账号甚至旧版本难以寻觅的窘境。所以这篇内容的目的就是帮你把这块基石铺得又平又稳。我会带你走一遍从选择版本、寻找可靠下载源到安装、配置环境变量再到最后验证的完整流程。不止是告诉你点击哪里更重要的是解释清楚每一步背后的逻辑为什么环境变量要那样配不同的JDK提供商如Oracle JDK、OpenJDK有什么区别如何管理多个JDK版本这些才是让你真正掌握这个技能并能举一反三解决未来环境配置问题的关键。无论你是计算机专业的学生还是准备转行的新人跟着这篇指南操作都能在10分钟内拥有一个可用的Java开发环境。2. JDK核心概念与版本选择策略在动手下载之前我们必须先搞清楚几个关键概念这直接决定了后续所有步骤的选择。2.1 JDK、JRE与JVM三者的关系与区别很多人会混淆这三个名词简单来说JVM (Java Virtual Machine)Java虚拟机。它是Java程序运行的“发动机”负责执行编译后的字节码.class文件。它实现了Java“一次编写到处运行”的核心特性。你无法单独安装JVM。JRE (Java Runtime Environment)Java运行时环境。它 JVM 运行Java程序所必需的核心类库。如果你只想运行别人写好的Java程序比如用Java开发的桌面软件安装JRE就足够了。JDK (Java Development Kit)Java开发工具包。它 JRE 开发工具如编译器javac、调试器jdb、打包工具jar等。你要做开发就必须安装JDK。安装了JDK自然就包含了JRE和JVM。注意从JDK 11开始Oracle的官方版本不再提供独立的JRE安装包。因为模块化之后你可以用JDK来自定义生成一个更小的JRE。但对于绝大多数开发者直接安装完整的JDK是最省事的选择。2.2 主流JDK发行版解析Oracle JDK vs OpenJDK这是选择版本时最大的分水岭。历史上Oracle JDK是官方正统但授权协议曾发生过重大变化。OpenJDK这是Java SE标准版的官方开源参考实现。你可以把它理解为Java的“源代码”和“标准答案”。它的许可证是GPLv2CPE对个人和商业使用都非常友好没有付费要求。现在包括Oracle在内的许多公司都基于OpenJDK源码构建自己的发行版。Oracle JDK这是Oracle公司基于OpenJDK源码构建的发行版。在JDK 8时代它对于商业用途需要付费许可。但从JDK 17开始情况又变了Oracle JDK 17及以后的版本在开源GPLv2协议下也提供了免费版本但如果你需要Oracle提供的商业支持和长期更新服务则需要付费订阅。对于绝大多数个人开发者、学生和学习者我的建议是优先选择其他厂商提供的OpenJDK发行版或者直接使用Oracle的免费OpenJDK构建版本。原因如下完全免费无需担心任何潜在的许可费用问题。功能一致在核心功能上与Oracle JDK几乎无差别。获取方便下载渠道多速度往往更快。2.3 如何选择JDK版本LTS与最新特性版的权衡Java版本迭代很快每半年发布一个特性版本。但不是每个版本都会获得长期支持。LTS (Long-Term Support) 长期支持版这些版本会获得数年的更新支持包括安全更新和错误修复是企业级应用和追求稳定性的项目的首选。目前主流的LTS版本有JDK 8经典、JDK 11、JDK 17、JDK 21。JDK 17是目前被广泛认为可以替代JDK 8的新一代LTS基准。非LTS版特性版每半年发布一次如JDK 18, 19, 20, 22, 23。它们只提供约6个月的支持主要用于体验最新语言特性和API。不适合用于生产环境。选择策略新手学习/学校课程优先确认你的教程或教材使用的版本。如果未指定选择JDK 17或JDK 21这两个较新的LTS版本是安全且现代的起点。企业开发/已有项目严格遵循项目要求。老项目可能锁定在JDK 8或11。个人新项目建议从JDK 21开始它是目前最新的LTS包含了Records、Pattern Matching、虚拟线程等大量现代特性。2.4 可靠的JDK下载镜像源推荐鉴于直接从Oracle官网下载可能较慢或需要登录这里推荐几个国内开发者常用的镜像源以下载OpenJDK发行版为主Adoptium (Eclipse Temurin)目前最受社区欢迎的免费OpenJDK发行版之一。由Eclipse基金会管理提供清晰的LTS和最新版本下载支持多种操作系统和架构。国内访问速度不错。官网adoptium.net/zh-CN微软OpenJDK微软维护的OpenJDK发行版质量可靠下载直接。官网learn.microsoft.com/zh-cn/java/openjdkAzul ZuluAzul Systems提供的OpenJDK发行版社区版免费同样提供长期支持。官网www.azul.com/downloads华为云镜像站提供了包括OpenJDK在内的多种开源软件镜像国内下载速度极快。地址mirrors.huaweicloud.com清华大学开源软件镜像站国内老牌镜像站软件齐全。地址mirrors.tuna.tsinghua.edu.cn实操心得对于国内用户我强烈推荐将Adoptium (Temurin)作为首选。它的网站界面友好版本分类清晰HotSpot JVM并且提供了直接的.msiWindows或.pkgmacOS安装包比解压压缩包配置起来更省心。如果追求极速下载可以去华为云或清华镜像站找到对应的版本压缩包。3. 手把手安装Windows/macOS/Linux全平台指南下面我将分平台演示安装过程。我们以在Windows和macOS上安装Adoptium JDK 21 (Temurin)为例Linux会给出通用命令。3.1 Windows平台安装详解Windows用户通常有两种选择安装程序.msi或压缩包.zip。前者会自动处理一些配置后者更灵活。步骤一下载安装程序访问adoptium.net/zh-CN。在首页选择版本如Temurin 21 (LTS)点击“下载”。在详情页选择操作系统Windows、架构x64除非你是ARM电脑、包类型Installer (.msi)然后点击最大的下载按钮。步骤二运行安装向导双击下载的.msi文件。在安装向导中点击“Next”。关键步骤设置安装路径。默认路径通常是C:\Program Files\Eclipse Adoptium\jdk-21.0.x.x-hotspot。我建议保持默认或者改到一个没有中文和空格的路径例如D:\DevTools\jdk-21。记住这个路径等下配置环境变量要用。接下来的选项如是否创建开始菜单文件夹可以按需选择。点击“Install”完成安装。步骤三验证安装初步安装完成后可以打开一个新的命令提示符CMD或 PowerShell输入java -version如果安装程序已经自动配置了部分环境变量你可能会看到类似下面的输出openjdk version 21.0.3 2024-10-15 LTS OpenJDK Runtime Environment Temurin-21.0.39 (build 21.0.39-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.39 (build 21.0.39-LTS, mixed mode, sharing)这说明JRE运行环境的路径已经被识别。但这并不代表JDK开发工具配置好了我们还需要检查编译器javac -version如果这个命令报错“不是内部或外部命令”那就说明我们还需要手动配置JAVA_HOME和Path环境变量。即使javac能用为了后续开发工具如Maven、Gradle能正确找到JDK手动配置JAVA_HOME也是一个好习惯。3.2 macOS平台安装详解macOS的安装体验通常更流畅通过.pkg安装包或Homebrew都可以。方法A使用.pkg安装包推荐新手在Adoptium网站选择macOS、架构Apple Silicon选aarch64Intel选x64、包类型Installer (.pkg)。下载后双击.pkg文件按提示一步步安装即可。安装程序会自动将JDK部署到系统标准目录/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home。安装后打开终端Terminal输入java -version和javac -version验证。通常.pkg安装后会自动配置两个命令都应成功。方法B使用Homebrew推荐开发者如果你已经安装了HomebrewmacOS包管理器安装JDK只是一条命令的事# 安装Eclipse Temurin的JDK 21 brew install --cask temurin21 # 或者安装Azul Zulu的JDK 21 brew install --cask zulu21安装后同样在终端验证。Homebrew会自动处理好路径链接。注意事项macOS可能会在系统更新后或者当你安装了多个JDK时出现版本混乱。你可以使用/usr/libexec/java_home -V命令查看所有已安装的JDK及其路径。如果需要切换版本可以通过设置JAVA_HOME环境变量来实现例如在~/.zshrc文件中添加export JAVA_HOME$(/usr/libexec/java_home -v 21)来指定使用JDK 21。3.3 Linux平台安装详解以Ubuntu为例Linux系统通常通过包管理器或解压压缩包来安装。方法A使用APT包管理器Ubuntu/Debian一些OpenJDK发行版提供了PPA软件源。对于Adoptium/Temurin可以按以下步骤# 1. 安装必要的工具 sudo apt update sudo apt install -y wget apt-transport-https # 2. 导入Adoptium的GPG密钥和仓库 wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /etc/apt/keyrings/adoptium.asc echo deb [signed-by/etc/apt/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(awk -F /^VERSION_CODENAME/{print$2} /etc/os-release) main | sudo tee /etc/apt/sources.list.d/adoptium.list # 3. 更新源并安装JDK 21 sudo apt update sudo apt install -y temurin-21-jdk # 4. 验证安装 java -version javac -version方法B手动下载.tar.gz压缩包这种方式更通用适用于所有Linux发行版。从Adoptium网站下载Linux的.tar.gz包例如x64架构。在终端中执行以下命令假设下载文件在~/Downloads# 1. 创建目标目录可选通常放在/usr/lib或/opt下 sudo mkdir -p /usr/lib/jvm # 2. 解压到目标目录 sudo tar -xzf ~/Downloads/OpenJDK21U-jdk_x64_linux_hotspot_21.0.3_9.tar.gz -C /usr/lib/jvm/ # 3. 重命名目录以便管理可选 cd /usr/lib/jvm sudo mv jdk-21.0.39 temurin-21 # 4. 接下来需要手动配置环境变量见下一章节4. 环境变量配置让系统认识你的JDK环境变量是操作系统用来存储全局配置信息的地方。配置JDK环境变量本质上就是告诉系统“我的JDK安装在哪里请让所有程序都能找到它。”4.1 核心环境变量JAVA_HOME与PATHJAVA_HOME这个变量指向你的JDK安装的根目录。很多Java开发工具如Maven、Gradle、Tomcat、IDE都依赖这个变量来定位JDK。它的值应该是像C:\Program Files\Eclipse Adoptium\jdk-21.0.x.x-hotspot或/usr/lib/jvm/temurin-21这样的路径。Path这是系统用来查找可执行文件的路径列表。当你在命令行输入javac时系统会遍历Path中的每一个目录寻找名为javac.exeWindows或javacmacOS/Linux的文件。我们需要将JDK的bin目录%JAVA_HOME%\bin或$JAVA_HOME/bin添加到Path中这样系统就能找到java,javac,jar等命令。为什么一定要配JAVA_HOME而不只是把bin目录加到Path标准化约定几乎所有Java生态工具都认JAVA_HOME。便于管理当你需要切换JDK版本时只需修改JAVA_HOME这一个变量的值所有依赖它的工具都会自动切换无需改动Path中复杂的条目。路径引用在脚本或配置文件中使用%JAVA_HOME%或$JAVA_HOME来引用路径比写死绝对路径更灵活、可移植。4.2 Windows系统环境变量配置图形化界面打开环境变量设置右键点击“此电脑”或“我的电脑”选择“属性”。点击“高级系统设置”。在弹出的“系统属性”窗口中点击右下角的“环境变量(N)...”按钮。新建JAVA_HOME系统变量在下面的“系统变量(S)”区域点击“新建...”。变量名JAVA_HOME变量值你的JDK安装路径例如C:\Program Files\Eclipse Adoptium\jdk-21.0.3.9-hotspot。关键技巧不要包含bin目录JAVA_HOME指向的是包含bin,lib,jmods等文件夹的根目录。一个快速验证方法是打开这个路径应该能看到bin文件夹在里面。编辑Path变量在“系统变量”列表中找到Path变量选中并点击“编辑”。在打开的编辑窗口中点击“新建”。添加一个新条目%JAVA_HOME%\bin重要顺序确保%JAVA_HOME%\bin这一条在列表中的位置相对靠前。因为如果有多个Java路径比如旧的JRE系统会使用Path中先找到的那个。你可以使用“上移”按钮将其移到顶部附近。验证配置关闭所有已打开的命令提示符窗口环境变量需要重启终端才能生效。打开一个新的命令提示符CMD或 PowerShell。依次输入以下命令echo %JAVA_HOME%这应该正确显示你设置的路径。java -version javac -version这两个命令都应该成功输出版本信息且版本号与你安装的一致。4.3 macOS/Linux系统环境变量配置Shell配置文件在macOS和Linux中环境变量通常在用户的家目录下的shell配置文件中设置。常见的shell是bash或zsh。确定你的Shell和配置文件打开终端。输入echo $SHELL查看当前shell。/bin/zsh表示zsh/bin/bash表示bash。zsh的配置文件是~/.zshrc。bash的配置文件是~/.bash_profile或~/.bashrc对于登录shell通常用.bash_profile。编辑配置文件以zsh为例# 使用文本编辑器如nano或vim打开配置文件 nano ~/.zshrc在文件的末尾添加以下几行# 设置JAVA_HOME请将路径替换为你的实际JDK路径 # 对于通过.pkg安装的Temurin路径通常是 export JAVA_HOME/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home # 如果你是通过Homebrew安装的路径可能类似 # export JAVA_HOME$(/usr/libexec/java_home -v 21) # 将JAVA_HOME的bin目录添加到PATH export PATH$JAVA_HOME/bin:$PATH注意$PATH前面的$JAVA_HOME/bin:表示将新路径添加到现有PATH的最前面。冒号:是Linux/macOS中路径的分隔符。使配置生效保存并关闭编辑器在nano中按CtrlX然后按Y再按回车。在终端中执行以下命令让配置文件立即生效source ~/.zshrc如果你修改的是.bash_profile则用source ~/.bash_profile验证配置echo $JAVA_HOME java -version javac -version4.4 验证配置成功的完整流程配置完成后不要只满足于java -version能运行。执行一个完整的“编译-运行”流程才是终极验证。创建一个简单的Java文件。在任意位置比如桌面新建一个文本文件命名为HelloWorld.java。用记事本或任何代码编辑器打开输入以下经典代码public class HelloWorld { public static void main(String[] args) { System.out.println(Hello, World! JDK环境配置成功); } }注意文件名HelloWorld.java必须与类名HelloWorld完全一致包括大小写。打开命令行终端导航到该文件所在目录。Windows:cd C:\Users\YourName\DesktopmacOS/Linux:cd ~/Desktop编译Java源文件javac HelloWorld.java如果成功不会有任何输出但目录下会生成一个HelloWorld.class文件。运行编译后的类文件java HelloWorld注意这里运行的是类名HelloWorld不是文件名HelloWorld.class。如果终端成功打印出Hello, World! JDK环境配置成功那么恭喜你你的JDK开发环境已经100%就绪。5. 多版本JDK管理与切换实战在实际开发中你很可能需要同时维护多个项目它们可能要求不同的JDK版本。学会管理多个JDK是一项必备技能。5.1 Windows下的多版本管理Windows没有内置的版本管理工具但我们可以通过灵活配置环境变量来实现。方法手动切换JAVA_HOME这是最直接的方法。你只需要安装多个版本的JDK到不同的目录然后在需要的时候去系统环境变量里修改JAVA_HOME的值指向对应的版本目录并确保Path中的%JAVA_HOME%\bin生效通常需要重启终端或电脑。更优雅的工具使用第三方版本管理器jEnv这是一个命令行工具虽然源自Unix但也有Windows版本如jenv-win。它可以让你轻松地在多个JDK版本间切换。IDE管理像IntelliJ IDEA、Eclipse这样的集成开发环境可以在项目级别或全局级别指定JDK无需修改系统环境变量。这是最常用的方式。5.2 macOS/Linux下的多版本管理Unix-like系统有更成熟的命令行工具。1. 使用jenv(推荐)jenv是一个轻量级的命令行工具可以设置全局、目录项目或shell会话级别的JDK版本。# 安装jenv (macOS使用Homebrew) brew install jenv # 将jenv初始化脚本添加到shell配置中 echo export PATH$HOME/.jenv/bin:$PATH ~/.zshrc echo eval $(jenv init -) ~/.zshrc source ~/.zshrc # 添加已安装的JDK到jenv管理 jenv add /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home jenv add /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home # 查看所有被管理的版本 jenv versions # 设置全局默认版本 jenv global 11 # 为当前shell会话设置版本 jenv shell 17 # 为特定目录项目设置本地版本会在目录下生成.jen-version文件 cd ~/my-java8-project jenv local 1.82. 使用update-alternatives(Linux, 如Ubuntu)这是Debian/Ubuntu系统自带的工具用于管理同一个命令的多个备选方案。# 假设你已经手动安装了两个JDK在 /usr/lib/jvm/ 下 # 注册JDK sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/temurin-11/bin/java 1100 sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/temurin-11/bin/javac 1100 sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/temurin-17/bin/java 1700 sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/temurin-17/bin/javac 1700 # 交互式选择默认版本 sudo update-alternatives --config java sudo update-alternatives --config javac5.3 在IDE中配置JDK以IntelliJ IDEA为例这是日常开发中最实用的方式。你可以在IDE中配置多个JDK并为每个项目指定一个。打开IntelliJ IDEA进入File-Project Structure(Windows/Linux) 或IntelliJ IDEA-Preferences-Build, Execution, Deployment-Build Tools-Project Structure(macOS)。在Project Structure窗口的左侧选择Platform Settings-SDKs。点击左上角的号选择Add JDK...。在弹出的文件选择器中导航到你的JDK安装根目录即JAVA_HOME指向的目录选中后点击OK。你可以重复此步骤添加多个版本的JDK。在Project Settings-Project中可以为当前项目选择Project SDK。在Project Settings-Modules中可以为每个模块单独指定SDK。这样你的系统环境变量可以保持稳定比如一直指向JDK 17而不同的IDEA项目则可以自由使用JDK 8、11或21互不干扰。6. 常见问题排查与深度解决方案即使按照步骤操作你也可能会遇到一些问题。这里汇总了最常见的坑和解决办法。6.1 问题速查表问题现象可能原因解决方案‘java’ 不是内部或外部命令1. JDK未安装。2.JAVA_HOME未设置或设置错误。3.%JAVA_HOME%\bin未添加到Path或Path修改未生效。1. 确认已安装JDK。2. 检查JAVA_HOME变量值是否为JDK根目录有bin文件夹。3. 检查Path重启命令行或电脑。‘javac’ 不是内部或外部命令JAVA_HOME指向了JRE目录而不是JDK目录。确保JAVA_HOME指向的是JDK安装目录包含javac.exe的父目录的父目录。java -version与javac -version版本不一致系统Path中存在多个Java路径且顺序有误。调整Path环境变量将%JAVA_HOME%\bin移至最前面。或检查是否有其他Java如JRE被优先调用。命令行生效但IDE如IDEA报错找不到JDKIDE未正确配置项目SDK或使用了独立的内部配置。在IDE的项目结构设置中手动添加并指定正确的JDK路径。安装后需要同意许可协议Oracle旧版下载的是Oracle JDK 8等旧版本安装过程需要点击接受许可。仔细阅读安装向导勾选接受许可协议的选项。或考虑换用OpenJDK发行版。在macOS上即使配置了JAVA_HOME某些脚本仍报错某些脚本或工具可能硬编码调用了/usr/libexec/java_home或系统默认Java。使用sudo ln -sfn $(JAVA_HOME) /Library/Java/JavaVirtualMachines/current.jdk创建一个软链接或者确保你的JAVA_HOME是通过/usr/libexec/java_home -v命令可以查询到的。6.2 深度排查技巧技巧一检查命令的完整路径当命令不执行时在终端使用whichmacOS/Linux或whereWindows命令查看系统实际调用了哪个程序。Windows:where javawhere javacmacOS/Linux:which javawhich javac这会输出命令所在的实际路径。如果路径不是你新配置的JDK的bin目录就说明环境变量没生效或者被覆盖了。技巧二在命令行中临时设置环境变量用于测试如果你不想重启终端或修改配置文件可以临时设置Windows (CMD):set JAVA_HOMEC:\你的\JDK\路径然后set Path%JAVA_HOME%\bin;%Path%Windows (PowerShell):$env:JAVA_HOME C:\你的\JDK\路径然后$env:Path $env:JAVA_HOME\bin; $env:PathmacOS/Linux:export JAVA_HOME/你的/JDK/路径然后export PATH$JAVA_HOME/bin:$PATH这样设置只对当前这个命令行窗口有效。关闭后失效。这是一个非常好的测试手段可以先验证路径是否正确再写入永久配置。技巧三处理Windows用户变量与系统变量的冲突Windows有“用户变量”和“系统变量”。如果同一个变量如JAVA_HOME在两个地方都定义了那么当前用户登录时“用户变量”会覆盖“系统变量”。检查时两个地方都要看避免重复或冲突。技巧四警惕安装程序自动添加的路径一些JDK安装程序尤其是Windows的.msi会自动在Path的开头添加一个指向其bin目录的绝对路径如C:\Program Files\Common Files\Oracle\Java\javapath。这个路径可能指向一个JRE或旧版本。当你手动配置了%JAVA_HOME%\bin后由于这个自动添加的路径在前系统会优先使用它。解决办法是在Path变量中找到并删除这个自动添加的条目或者确保你的%JAVA_HOME%\bin在它前面。6.3 关于镜像网站与下载加速如果你从主站下载速度慢可以尝试使用国内镜像站。例如在华为云镜像站你可以找到openjdk目录里面通常有Adoptium/Temurin的归档。下载时注意选择正确的操作系统、架构和文件类型如tar.gz,msi,pkg。对于其他开发环境配置如Maven、Node.js同理也可以寻找对应的镜像源来加速下载例如将Maven的settings.xml中的仓库地址改为阿里云镜像。这能极大提升环境搭建的效率。