Java 开发的第一步就是把 JDK 环境搭好。这一步看着简单但不少新手会在环境变量配置上踩坑——JAVA_HOME 没设对、javac 报“不是内部或外部命令”、改完变量终端里还是不生效……这些坑我都替你踩过一遍了。这篇文章就用最直白的方式手把手带你完成 JDK 的下载、安装和环境配置涵盖 Windows、macOS 和 Linux 三个平台每一步都有图文说明跟着走绝对不会错。文中所有操作截图均为 Windows 11 JDK 21 环境其他系统和版本的操作逻辑完全一致。一、先搞清楚几个基本概念在下载之前简单了解一下这几个名词后续配置环境变量时会更好理解缩写全称通俗解释JVMJava Virtual MachineJava 虚拟机负责把 Java 字节码翻译成机器指令是“一次编写到处运行”的底层支撑JREJava Runtime EnvironmentJava 运行时环境包含 JVM 核心类库。如果只需要运行Java 程序装它就够JDKJava Development KitJava 开发工具包包含 JRE 编译器javac 调试器等开发工具。作为开发者必须装 JDK简单记JDK 包含 JREJRE 包含 JVM三者是逐层嵌套的关系。我们写代码要装的就是 JDK。二、JDK 版本怎么选Java 版本更新很快但不是每个版本都适合长期使用。强烈建议选择 LTSLong Term Support长期支持版本这类版本会持续获得安全补丁和性能优化稳定性有保障。当前主流的 LTS 版本如下版本状态特点推荐场景JDK 21最新 LTS虚拟线程、分代 ZGC、模式匹配增强等重大特性新项目首选性能和并发能力最强JDK 17主流 LTS稳定、长期维护密封类、模式匹配等现代特性学习入门 企业开发首选兼容性最成熟JDK 11旧 LTS经典版本HTTP 客户端、var 类型推断维护老项目兼容性要求高的环境JDK 8经典版本Lambda 表达式、Stream API市场占有率最高传统企业项目、教学基础建议如果你是 Java 新手或者新开一个项目直接选 JDK 17 或 JDK 21。两者都是 LTS 版本生态成熟教程资料也最多不用担心短期版本过时的问题。JDK 8 虽然仍有大量企业使用但新学者建议从更新的 LTS 版本入手。三、JDK 下载渠道下载 JDK 有三个靠谱渠道按推荐程度排序① Eclipse Temurin最推荐官网https://adoptium.net/由 Eclipse 基金会维护完全免费开源通过 OpenJDK TCK 官方认证更新及时下载无需注册账号② Oracle 官方网站官网https://www.oracle.com/java/technologies/downloads/官方最权威但需要注册 Oracle 账号商业使用注意许可协议③ 国内镜像站下载更快华为云镜像站 / 阿里云开源镜像站 / 清华大学 TUNA 镜像站同步及时下载速度极快适合网络访问外网较慢的用户也可以通过我分享的网盘链接下载百度网盘JDK 链接: https://pan.baidu.com/s/1wpLt8ZLSyLcpS_pjyxWX8g 提取码: aq6s内涵WindowsLinuxmacOS系统的2117118版本还是比较全的可以挑选下载下载时注意选择正确的系统版本Windows选x64 Installer.exe 或 .msimacOSIntel 芯片选x64M1/M2/M3 芯片选ARM64.dmg 或 .pkgLinux用uname -m确认架构常见为x86_64或aarch64选.tar.gz或.deb/.rpm四、Windows 系统安装 JDK4.1 运行安装程序下载完成后右键点击.exe安装包选择“以管理员身份运行”避免后续权限不足的问题。4.2 自定义安装路径重要在安装向导中点击“更改”按钮修改安装路径。这一步很关键建议遵循以下原则不要装到 C 盘避免占用系统盘空间建议 D 盘路径中不要有中文如D:\软件\JDK❌路径中不要有空格如C:\Program Files\Java\jdk-21的Program Files有空格虽不影响大部分场景但某些旧脚本可能解析失败推荐路径示例D:\Java\jdk-21或C:\dev\jdk-21简洁、全英文、无空格4.3 完成安装确保“开发工具”Development Tools选项被勾选这是编译 Java 代码的核心组件。然后一路点击“下一步”等待进度条走完即可。4.4 配置环境变量最核心的一步安装完成只是把 JDK 文件放进了硬盘操作系统还不知道 Java 命令在哪里。环境变量的作用就是告诉 Windows“Java 工具在这里你来用吧。”步骤 1打开环境变量设置界面右键点击“此电脑”→“属性”→“高级系统设置”→ 点击“环境变量”按钮。步骤 2新建 JAVA_HOME 变量在“系统变量”区域注意不是“用户变量”点击“新建”变量名JAVA_HOME变量值填写你刚才安装 JDK 的根目录路径例如D:\JDK21注意变量值不要包含\binJAVA_HOME 必须指向 JDK 根目录而不是 bin 子目录。Maven、Tomcat、Gradle 等工具都会读取 JAVA_HOME 来定位 JDK 的核心文件如lib\tools.jar指错了这些工具就找不到 javac 编译器了。步骤 3编辑 Path 变量在“系统变量”中找到Path变量选中后点击“编辑”然后点击“新建”输入%JAVA_HOME%\bin为什么用%JAVA_HOME%\bin而不是直接写死路径假如你直接写了D:\Java\jdk-21\bin以后想升级到 JDK 25就得同时修改 JAVA_HOME 和 Path 两个地方很容易漏掉一个导致混乱。用变量引用只需改 JAVA_HOME 一处Path 自动跟着变。4.5 验证是否配置成功配置完成后一定要重新打开一个新的命令提示符窗口已经打开的 CMD 不会自动加载新配置按Win R输入cmd回车打开新 CMD 窗口依次执行以下三条命令每条输完按回车java -versionjavac -version正确的输出效果版本号根据你安装的实际版本而定如果三条命令都正常返回信息说明 JDK 安装和环境变量配置完全成功五、macOS 系统配置5.1 安装 JDKmacOS 推荐使用 Homebrew 安装一行命令搞定bashbrew install openjdk21如果习惯手动下载可以去 Oracle 官网或 Eclipse Temurin 下载.dmg安装包双击按向导安装即可。安装后 JDK 位于/Library/Java/JavaVirtualMachines/目录下。5.2 配置环境变量macOS 15 默认使用 Zsh 作为终端编辑~/.zshrc文件bashnano ~/.zshrc在文件末尾添加以下内容路径请根据你实际安装的 JDK 版本调整bashexport JAVA_HOME$(/usr/libexec/java_home) export PATH$JAVA_HOME/bin:$PATH保存后执行以下命令使配置立即生效bashsource ~/.zshrc5.3 验证打开终端执行bashjava -version javac -version正确显示版本信息即表示配置成功。六、LinuxUbuntu/Debian系统配置6.1 安装 JDKbashsudo apt update sudo apt install openjdk-21-jdk6.2 配置环境变量编辑/etc/profile全局配置所有用户生效或~/.bashrc仅当前用户生效bashsudo nano /etc/profile在文件末尾添加bashexport JAVA_HOME/usr/lib/jvm/java-21-openjdk-amd64 export PATH$JAVA_HOME/bin:$PATH保存后执行bashsource /etc/profile6.3 验证bashjava -version javac -version七、常见问题排查指南这一节整理了新手配置 JDK 环境时最容易遇到的几个坑遇到问题可以直接对照排查。问题现象可能原因解决办法java -version正常但javac提示“不是内部或外部命令”Path 中没有%JAVA_HOME%\bin或 Path 配置在了用户变量而 CMD 读取的是系统变量检查系统变量 Path 是否包含%JAVA_HOME%\bin建议系统变量和用户变量都配一遍修改环境变量后 CMD 中仍不生效没有重新打开 CMD 窗口已打开的窗口不会自动加载新配置关闭所有 CMD 窗口重新打开一个新的echo %JAVA_HOME%显示为空或路径错误JAVA_HOME 没配或者变量名拼写错误如写成了JAVA HOME带空格检查变量名是否为JAVA_HOME大写、下划线变量值是否正确指向 JDK 根目录安装路径包含中文或空格导致某些工具报错旧版 Eclipse 或 Maven 对含空格/中文的路径解析有问题卸载 JDK重新安装到纯英文、无空格的路径如D:\Java\jdk-21多个 JDK 版本共存版本混乱Path 中有多个 Java 路径顺序靠前的被优先调用将%JAVA_HOME%\bin上移到 Path 列表的最前面CMD 中输入java一闪而过安装的是 JRE 而非 JDKJRE 没有 javac 编译器下载完整 JDK 安装包而不是 JRE重新安装快速排查技巧如果三条验证命令全部失败大概率是 JAVA_HOME 没配对或 Path 没加对如果只有 javac 失败多半是 JAVA_HOME 路径最后多写了\bin。八、总结本文以 JDK 21 为例完整演示了 Windows、macOS 和 Linux 三个平台下 JDK 的下载、安装和环境变量配置全流程。核心要点回顾版本选择新手首选 JDK 17 或 JDK 21LTS 版本稳定可靠下载渠道推荐 Eclipse Temurin免注册、完全免费、官方认证安装路径全英文、无空格、非系统盘环境变量JAVA_HOME指向 JDK 根目录不含\binPath中添加%JAVA_HOME%\bin验证配置重新打开 CMD执行java -version和javac -version确认如果在配置过程中遇到问题欢迎在评论区留言我会尽快回复。觉得文章有帮助的话记得点赞 收藏后续我会继续更新 Java 开发环境搭建系列IDEA 安装、Maven 配置、Git 集成等关注我不迷路