最近在帮团队统一开发环境时发现不少同学对 JDK 的安装和环境配置尤其是新版本 JDK 26 的适配存在不少困惑。网上的教程要么版本过时要么只讲安装不讲环境变量导致开发时出现各种“找不到主类”或“版本不匹配”的报错。本文将手把手带你完成从 JDK 26 下载安装、环境变量配置到主流 IDEIntelliJ IDEA集成的全流程并重点解决 Lombok 兼容性、模块化路径等高频问题。无论你是 Java 新手准备搭建第一个开发环境还是老手需要升级到最新版本都能从这篇实战指南中找到清晰的步骤和避坑方案。1. 理解 JDK、JRE 与 Java 运行时环境在开始安装之前厘清几个核心概念至关重要这能帮助你理解每一步操作的目的并在出现问题时快速定位。JDK (Java Development Kit) - Java 开发工具包这是开发者的核心武器。JDK 不仅包含了运行 Java 程序所必需的JRE (Java Runtime Environment)还额外提供了编译器 (javac)、调试器 (jdb)、文档生成器 (javadoc)、打包工具 (jar) 等一系列开发工具。简单来说你要编写和编译 Java 代码就必须安装 JDK。本文的主角 JDK 26 就是一个完整的开发工具包。JRE (Java Runtime Environment) - Java 运行时环境如果你只想运行一个已经编译好的.jar或.class文件比如使用别人开发的软件那么只安装 JRE 就足够了。它包含了JVM (Java 虚拟机)和 Java 核心类库。JVM 是实现 Java “一次编写到处运行”跨平台特性的关键它负责将字节码解释或编译为特定平台的机器指令。环境变量的作用在命令行中直接输入java或javac时操作系统需要知道去哪里找到这些可执行文件。JAVA_HOME和Path这两个环境变量就是用来告诉系统 JDK 的安装位置的。JAVA_HOME通常指向 JDK 的根目录例如C:\Program Files\Java\jdk-26而Path变量中则会添加%JAVA_HOME%\bin这样系统就能在任意路径下识别java和javac等命令。为什么选择 JDK 26JDK 26 是 Oracle 标准 Java 的最新版本截至撰写时它带来了语言特性、性能提升和 API 的持续更新。对于学习者和新项目使用最新版本可以接触到最新的语言规范。但在企业生产环境中版本选择需谨慎通常会更倾向于 LTS长期支持版本如 JDK 17、JDK 21。本文以 JDK 26 为例其安装和配置方法与其它版本大同小异核心思路是相通的。2. 环境准备与安装规划在动手下载之前做好准备工作能让整个过程更顺畅。2.1 操作系统确认本文演示将覆盖 Windows、macOS 和 Linux 三大主流平台。请先确认你的操作系统类型64位或ARM架构。目前绝大多数个人电脑都是 64 位系统。2.2 清理旧版本可选但推荐如果你的电脑上已经存在旧版本的 JDK比如 JDK 8, 11, 17为了避免冲突建议先检查并规划管理。Windows: 打开“控制面板” - “程序” - “卸载程序”查看已安装的 Java。macOS: 在终端执行/usr/libexec/java_home -V查看所有已安装的 JDK 路径。Linux: 使用update-alternatives --config java或直接检查/usr/lib/jvm目录。重要建议不建议直接卸载公司项目正在依赖的旧版本。可以采取多版本共存的方式并通过环境变量或 IDE 配置来灵活切换。本文也会介绍如何配置JAVA_HOME指向特定版本。2.3 确定安装目录选择一个你拥有读写权限、且路径中不包含中文或空格的目录作为 JDK 的安装位置。这是避免后续各种诡异问题的好习惯。Windows 推荐:C:\Develop\Java\jdk-26macOS/Linux 推荐:/Library/Java/JavaVirtualMachines/jdk-26.jdk(macOS) 或/usr/lib/jvm/jdk-26(Linux)规划好之后我们就可以开始下载了。3. 下载与安装 JDK 263.1 访问官方下载页面为了避免下载到捆绑软件或修改版强烈建议从官方网站下载。打开浏览器访问 Oracle Java SE 下载页面 或 OpenJDK 发行版站点 。在 Oracle 页面你需要先点击接受许可协议。然后根据你的操作系统选择对应的安装包。Windows: 选择x64 Installer(.exe文件) 或x64 Compressed Archive(.zip压缩包)。macOS: 选择ARM64 DMG Installer(Apple Silicon 芯片) 或x64 DMG Installer(Intel 芯片)。Linux: 选择x64 Compressed Archive(.tar.gz) 或RPM Package。3.2 执行安装程序对于 Windows.exe安装包或 macOS.dmg文件双击下载好的安装文件。跟随安装向导步骤。在 Windows 上可以点击“更改”按钮将安装路径修改为你之前规划的目录如C:\Develop\Java\jdk-26。在 macOS 上通常直接将 JDK 拖入Applications文件夹即可。点击“下一步”或“安装”直至完成。对于压缩包.zip或.tar.gz这种方式更灵活适合所有平台尤其是 Linux 和喜欢绿色安装的用户。将下载的压缩包移动到你规划的安装目录下。解压压缩包。Windows: 右键点击压缩包选择“全部解压缩...”目标文件夹选择C:\Develop\Java解压后会得到一个类似jdk-26的文件夹。macOS/Linux: 打开终端使用tar命令解压。# 假设下载的包在 ~/Downloads目标安装目录为 /Library/Java/JavaVirtualMachines (macOS) sudo tar -xzf ~/Downloads/jdk-26_linux-x64_bin.tar.gz -C /Library/Java/JavaVirtualMachines/ # 或解压到 /usr/lib/jvm (Linux) sudo tar -xzf ~/Downloads/jdk-26_linux-x64_bin.tar.gz -C /usr/lib/jvm/安装/解压完成后你会在目标目录下看到一个名为jdk-26或类似的文件夹。这就是你的 JDK 根目录。4. 配置系统环境变量这是最关键的一步配置不当会导致命令行无法识别 Java 命令。4.1 Windows 系统配置打开“开始”菜单搜索“环境变量”选择“编辑系统环境变量”。在弹出的“系统属性”窗口中点击右下角的“环境变量”按钮。新建系统变量JAVA_HOME在“系统变量”区域点击“新建”。变量名JAVA_HOME变量值你的 JDK 26 安装的根目录路径例如C:\Develop\Java\jdk-26。点击“确定”。修改系统变量Path在“系统变量”区域找到并选中Path变量点击“编辑”。点击“新建”然后添加一行%JAVA_HOME%\bin重要为了确保系统优先使用我们设置的 JDK 26可以将这一行通过“上移”按钮移动到列表顶部。点击“确定”保存。4.2 macOS / Linux 系统配置通常通过修改 shell 配置文件来设置环境变量如~/.zshrc(macOS Catalina 及以后) 或~/.bashrc(Linux 或旧版 macOS)。打开终端。使用文本编辑器打开配置文件。# macOS (Zsh) open -e ~/.zshrc # 或使用 vim/nano # vim ~/.zshrc # Linux (Bash) vim ~/.bashrc在文件末尾添加以下内容# 设置 JAVA_HOME请将路径替换为你的实际 JDK 26 路径 export JAVA_HOME/Library/Java/JavaVirtualMachines/jdk-26.jdk/Contents/Home # macOS 示例 # export JAVA_HOME/usr/lib/jvm/jdk-26 # Linux 示例 # 将 JDK 的 bin 目录添加到 PATH export PATH$JAVA_HOME/bin:$PATH注意$PATH前的:用于分隔不同路径。$JAVA_HOME/bin:$PATH表示将新路径加在原有 PATH 之前优先使用。保存并关闭文件。让配置立即生效# macOS (Zsh) source ~/.zshrc # Linux (Bash) source ~/.bashrc4.3 验证环境变量配置打开一个新的命令行窗口重要以确保读取到新的环境变量执行以下命令java -version javac -version echo %JAVA_HOME% # Windows echo $JAVA_HOME # macOS/Linux如果java -version和javac -version显示的信息中包含了26或类似26.0.1并且JAVA_HOME输出正确的路径那么恭喜你JDK 安装和环境变量配置成功5. 在 IntelliJ IDEA 中配置 JDK 26IDE 是开发的主战场我们需要告诉 IDEA 使用刚刚安装的 JDK 26。5.1 配置全局 JDKProject SDK打开 IntelliJ IDEA。对于新项目在欢迎界面点击“New Project”。对于已有项目点击File-Project Structure(快捷键CtrlAltShiftS)。在Project Structure窗口中左侧选择Project。在右侧的Project SDK下拉框旁点击New...-Add JDK...。在弹出的文件选择器中导航到你的 JDK 26 的根目录即JAVA_HOME指向的目录例如C:\Develop\Java\jdk-26选中后点击OK。IDEA 会识别该 JDK并将其命名为 “jdk-26”。点击Apply-OK。5.2 配置模块的 Language Level在同一个Project Structure窗口中左侧选择Modules然后在右侧的Sources标签页下确保Language level设置为与 JDK 26 对应的版本例如26 - Sealed types, always-strict floating-point semantics。这决定了 IDE 的语法检查和自动补全支持到哪个 Java 版本。5.3 验证 IDEA 中的配置创建一个新的 Java 类文件编写一个简单的HelloWorld// 文件路径src/main/java/com/example/HelloWorld.java package com.example; public class HelloWorld { public static void main(String[] args) { System.out.println(Hello from JDK 26!); // 可以尝试使用 JDK 16 的简单新特性如文本块预览特性可能已转正 String json { name: CSDN, version: 26 } ; System.out.println(json); } }右键点击运行HelloWorld.main()如果能在控制台看到输出说明 IDEA 已成功使用 JDK 26 编译和运行你的程序。6. 常见问题与深度排查即使按照步骤操作也可能遇到问题。以下是高频问题的排查思路。6.1 命令提示“不是内部或外部命令”现象在命令行输入java或javac后系统提示“不是内部或外部命令也不是可运行的程序”。原因Path环境变量未正确配置或配置后未重启命令行窗口。解决检查JAVA_HOME变量值是否正确指向了 JDK 的根目录包含bin文件夹的目录。检查Path变量中是否包含了%JAVA_HOME%\binWindows或$JAVA_HOME/binmacOS/Linux。务必关闭当前所有命令行窗口重新打开一个新的再测试。环境变量修改需要在新进程中生效。6.2 版本号不对显示旧版本现象java -version显示的是旧版本如 1.8而不是 26。原因系统Path变量中旧版本 JDK/JRE 的路径排在前面被优先找到了。解决Windows在环境变量的Path编辑框中将%JAVA_HOME%\bin这一行上移到列表的最顶端。macOS/Linux确保在 shell 配置文件如.zshrc中PATH的设置是export PATH$JAVA_HOME/bin:$PATH即将新 JDK 路径放在最前面。也可以检查并卸载不必要的旧版本 JRE通过控制面板。6.3 Lombok 等注解处理器报兼容性警告现象在 IDEA 中编译时可能出现类似you aren‘t using a compiler supported by lombok, so lombok will not work的警告。原因Lombok 等库通过操作编译器的抽象语法树AST来实现功能对 JDK 内部 API 有依赖。每当 JDK 大版本更新这些内部 API 可能发生变化导致 Lombok 的旧版本不兼容。解决升级 Lombok 版本这是最根本的解决方法。访问 Lombok 官网 或 Maven 中央仓库查找支持 JDK 26 的最新版本。在项目的构建工具中更新依赖版本。!-- Maven pom.xml 示例 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.34/version !-- 使用最新稳定版 -- scopeprovided/scope /dependency在 IDEA 中确保Settings - Build, Execution, Deployment - Compiler - Annotation Processors中的Enable annotation processing已勾选。重启 IDEA 并执行File - Invalidate Caches and Restart...清除缓存。6.4 “Java 文件位于模块源根之外因此不会被编译”现象IDEA 在文件顶部提示此警告文件图标可能变灰。原因项目模块的源代码根目录Sources Root设置不正确IDEA 无法识别该 Java 文件属于哪个模块。解决在项目视图中右键点击包含源代码的文件夹通常是src/main/java。选择Mark Directory as-Sources Root。文件夹会变成蓝色。同样可以将src/main/resources标记为Resources Root将src/test/java标记为Test Sources Root。6.5 运行时内存不足 (OutOfMemoryError)现象运行程序时抛出java.lang.OutOfMemoryError: Java heap space。原因JVM 堆内存分配不足无法满足程序运行需求。解决可以通过 JVM 参数调整堆内存大小。在 IDEA 中点击运行配置旁边的下拉菜单选择Edit Configurations...。在VM options输入框中添加参数例如-Xms512m -Xmx2048m。这表示初始堆内存 512MB最大堆内存 2048MB。对于大型应用或服务器需要根据实际情况调整。7. 最佳实践与工程化建议搭建好环境只是第一步遵循良好的实践能让开发更高效、更稳定。7.1 使用版本管理工具管理 JDK对于团队项目建议使用像 SDKMAN! (macOS/Linux) 或 Jabba 这样的 JDK 版本管理工具。它们可以让你轻松地在多个 JDK 版本间切换并确保团队成员使用统一的版本。# 使用 SDKMAN! 安装和管理 JDK sdk list java # 列出所有可安装的版本 sdk install java 26.0.1-oracle # 安装指定版本 sdk use java 26.0.1-oracle # 在当前 shell 切换版本7.2 项目构建工具中的 JDK 指定在 Maven 或 Gradle 构建脚本中显式指定 Java 版本避免依赖开发人员本地环境。Maven (pom.xml):properties maven.compiler.source26/maven.compiler.source maven.compiler.target26/maven.compiler.target /propertiesGradle (build.gradle):sourceCompatibility JavaVersion.VERSION_26 targetCompatibility JavaVersion.VERSION_267.3 区分开发环境与生产环境开发环境可以使用最新的 JDK 版本如 26体验新特性。测试/生产环境务必使用与开发环境一致或兼容的 JDK 版本。强烈推荐使用LTS长期支持版本如 JDK 17, 21用于生产环境以获得更长时间的安全更新和支持。JDK 26 是非 LTS 版本通常用于评估和前瞻性开发。7.4 保持环境整洁定期清理~/.m2/repository(Maven本地仓库) 和~/.gradle/caches(Gradle缓存) 中无用的依赖包。在 IDEA 中定期使用File - Invalidate Caches and Restart...来修复一些潜在的 IDE 元数据问题。7.5 文档化环境配置为你的项目创建一份README.md或CONTRIBUTING.md文件明确写明所需的 JDK 版本如JDK 26。构建工具Maven/Gradle及其版本。环境变量设置步骤。常见的环境问题及解决方法。 这能极大降低新成员加入的成本。从下载 JDK 26 安装包到配置系统环境变量再到集成到 IntelliJ IDEA 中我们完成了一个 Java 开发环境搭建的标准闭环。过程中重点攻克了版本冲突、Lombok 兼容性、模块化路径等典型难题。记住一个稳定且配置正确的开发环境是高效编码的基础。建议你将环境变量配置、IDE 设置等步骤记录成自己的备忘清单。接下来你可以尝试探索 JDK 26 引入的新语言特性或者开始你的第一个 Spring Boot 项目将环境真正用于实战。如果在后续使用中遇到其他环境相关问题欢迎在评论区交流探讨。