Java 开发的第一步，就是把 JDK 环境搭好。这一步看着简单，但不少新手会在环境变量配置上踩坑——JAVA_HOME 没设对、javac 报“不是内部或外部命令”、改完变量终端里还是不生效……这些坑我都替你踩过一遍了。
这篇文章就用最直白的方式，手把手带你完成 JDK 的下载、安装和环境配置，涵盖 Windows、macOS 和 Linux 三个平台，每一步都有图文说明，跟着走绝对不会错。
文中所有操作截图均为 Windows 10 + JDK 21 环境，其他系统和版本的操作逻辑完全一致。
一、先搞清楚几个基本概念
在下载之前，简单了解一下这几个名词，后续配置环境变量时会更好理解：
| JVM | Java Virtual Machine | Java 虚拟机，负责把 Java 字节码翻译成机器指令，是“一次编写，到处运行”的底层支撑 |
| JRE | Java Runtime Environment | Java 运行时环境，包含 JVM + 核心类库。如果只需要运行 Java 程序，装它就够 |
| JDK | Java Development Kit | Java 开发工具包，包含 JRE + 编译器（javac）+ 调试器等开发工具。作为开发者，必须装 JDK |
简单记：JDK 包含 JRE，JRE 包含 JVM，三者是逐层嵌套的关系。我们写代码要装的就是 JDK。
二、JDK 版本怎么选？
Java 版本更新很快，但不是每个版本都适合长期使用。强烈建议选择 LTS（Long 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 内涵Windows，Linux，macOS系统的21，17，11，8版本还是比较全的可以挑选下载
下载时注意选择正确的系统版本：
-
Windows：选 x64 Installer（.exe 或 .msi）
-
macOS：Intel 芯片选 x64，M1/M2/M3 芯片选 ARM64（.dmg 或 .pkg）
-
Linux：用 uname -m 确认架构，常见为 x86_64 或 aarch64，选 .tar.gz 或 .deb/.rpm
-
四、Windows 系统安装 JDK
4.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
注意：变量值不要包含 \\bin！JAVA_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 -version
- javac -version
正确的输出效果（版本号根据你安装的实际版本而定）：
如果三两条命令都正常返回信息，说明 JDK 安装和环境变量配置完全成功！
五、macOS 系统配置
5.1 安装 JDK
macOS 推荐使用 Homebrew 安装，一行命令搞定：
bash
brew install openjdk@21
如果习惯手动下载，可以去 Oracle 官网或 Eclipse Temurin 下载 .dmg 安装包，双击按向导安装即可。安装后 JDK 位于 /Library/Java/JavaVirtualMachines/ 目录下。
5.2 配置环境变量
macOS 15 默认使用 Zsh 作为终端，编辑 ~/.zshrc 文件：
bash
nano ~/.zshrc
在文件末尾添加以下内容（路径请根据你实际安装的 JDK 版本调整）：
bash
export JAVA_HOME=$(/usr/libexec/java_home)
export PATH=$JAVA_HOME/bin:$PATH
保存后执行以下命令使配置立即生效：
bash
source ~/.zshrc
5.3 验证
打开终端，执行：
bash
java -version
javac -version
正确显示版本信息即表示配置成功。
六、Linux（Ubuntu/Debian）系统配置
6.1 安装 JDK
bash
sudo apt update
sudo apt install openjdk-21-jdk
6.2 配置环境变量
编辑 /etc/profile（全局配置，所有用户生效）或 ~/.bashrc（仅当前用户生效）：
bash
sudo nano /etc/profile
在文件末尾添加：
bash
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
保存后执行：
bash
source /etc/profile
6.3 验证
bash
java -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 而非 JDK，JRE 没有 javac 编译器 | 下载完整 JDK 安装包（而不是 JRE），重新安装 |
💡 快速排查技巧：如果三条验证命令全部失败，大概率是 JAVA_HOME 没配对或 Path 没加对；如果只有 javac 失败，多半是 JAVA_HOME 路径最后多写了 \\bin。
八、总结
本文以 JDK 21 为例，完整演示了 Windows、macOS 和 Linux 三个平台下 JDK 的下载、安装和环境变量配置全流程。核心要点回顾：
版本选择：新手首选 JDK 17 或 JDK 21（LTS 版本），稳定可靠
下载渠道：推荐 Eclipse Temurin，免注册、完全免费、官方认证
安装路径：全英文、无空格、非系统盘
环境变量：JAVA_HOME 指向 JDK 根目录（不含 \\bin），Path 中添加 %JAVA_HOME%\\bin
验证配置：重新打开 CMD，执行 java -version 和 javac -version 确认
如果在配置过程中遇到问题，欢迎在评论区留言，我会尽快回复。觉得文章有帮助的话，记得点赞 + 收藏，后续我会继续更新 Java 开发环境搭建系列（IDEA 安装、Maven 配置、Git 集成等），关注我不迷路！
