很多 Java 开发新手，在 Ubuntu 系统搭建开发环境时，总会卡在 JDK 安装、环境变量配置、版本冲突等问题上。不同于 Windows 可视化安装，Ubuntu 的 JDK 部署以终端命令为主，掌握正确步骤可以一次配置、永久使用。
今天给大家整理一套适配 Ubuntu 20.04/22.04/24.04 全版本的 JDK 安装教程，包含主流的 OpenJDK（开源免费、企业首选）和 Oracle JDK 两种安装方式，附带环境变量配置、版本切换、安装验证、常见报错解决，零基础也能轻松上手。
一、前置说明：OpenJDK vs Oracle JDK
安装前先分清两个版本，避免装错影响开发：
- OpenJDK（推荐）：开源免费、无版权商用风险，Ubuntu 官方源直接支持，更新稳定，适配绝大多数 Java 项目、后端开发、服务器部署，是目前行业主流选择。
- Oracle JDK：Oracle 官方商业版本，新版有商用授权限制，仅适合需要官方专属特性、兼容老旧商业项目的场景，安装流程相对复杂。
个人开发、服务器部署、日常学习优先选择 OpenJDK，本文重点讲解该方案，文末附带 Oracle JDK 安装方法。
二、最简方案：APT 安装 OpenJDK（一键安装）
该方法通过 Ubuntu 官方软件源安装，无需手动解压、配置复杂路径，自动适配系统架构，全程仅需几条命令。
1. 更新软件源缓存
打开终端（快捷键 Ctrl+Alt+T），先更新系统软件源，保证安装包最新：
sudo apt update && sudo apt upgrade -y2. 安装对应版本 JDK
优先选择 LTS 长期支持版本（稳定无坑），根据项目需求选择安装：
# 安装 JDK11（最经典、兼容所有老旧项目，企业通用）
sudo apt install openjdk-11-jdk -y# 安装 JDK17（最新主流 LTS 版本，适配 SpringBoot3、新框架）
sudo apt install openjdk-17-jdk -y# 安装 JDK21（最新长期支持版，前沿项目使用）
sudo apt install openjdk-21-jdk -y3. 验证安装是否成功
安装完成后，通过以下两条命令验证，同时校验运行环境和编译环境：
# 查看 Java 运行版本
java -version
# 查看 JDK 编译版本（关键！有输出才是完整 JDK）
javac -version出现对应版本信息即安装成功，如果 javac 无输出，说明仅安装了 JRE 运行环境，需重新安装完整 JDK 包。
三、关键步骤：配置 JAVA_HOME 环境变量
大部分 Java 工具（Maven、Tomcat、SpringBoot、IDE）都依赖 JAVA_HOME 变量，不配置会导致项目启动失败、工具报错，必须设置！
1. 查找 JDK 安装路径
sudo update-alternatives --config java执行后会输出安装路径，示例：/usr/lib/jvm/java-17-openjdk-amd64，复制该路径（每个人路径基本一致，根据自己输出为准）。
2. 编辑环境变量配置文件
编辑用户全局环境变量文件，永久生效：
nano ~/.bashrc滑动到文件最末尾，添加以下配置，路径替换为你刚刚复制的 JDK 路径：
# JDK Environment
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH3. 生效配置并验证
保存退出（Ctrl+O 回车保存，Ctrl+X 退出），执行命令让配置立即生效：
source ~/.bashrc
# 验证 JAVA_HOME 是否配置成功
echo $JAVA_HOME输出刚刚设置的路径，说明环境变量配置完成。
四、多版本 JDK 切换教程
如果系统安装了多个 JDK 版本（11/17/21），可一键切换默认版本：
sudo update-alternatives --config java终端会列出所有已安装的 Java 版本，输入对应序号，回车即可切换默认版本，无需重复配置环境变量。
五、进阶方案：手动压缩包安装 JDK（通用所有版本）
如果需要安装特殊版本、自定义安装路径，可使用 tar 压缩包手动安装，适配所有 Ubuntu 版本：
1. 下载 JDK 压缩包
前往 OpenJDK 官网，下载 Linux x64 版本的 tar.gz 压缩包，默认保存到 Downloads 目录。
2. 创建安装目录并解压
# 创建 jdk 统一存放目录
sudo mkdir -p /usr/lib/jvm
# 解压压缩包到指定目录（替换为你的文件名）
sudo tar -zxf ~/Downloads/openjdk-*.tar.gz -C /usr/lib/jvm/3. 配置环境变量
参考本文第三部分，将 JAVA_HOME 路径改为解压后的 JDK 目录即可，后续验证步骤一致。
六、Oracle JDK 简要安装说明
Oracle JDK 无官方源一键安装，需要手动下载 deb 安装包，且新版存在商用授权限制：
- 官网下载对应 Linux .deb 安装包；
- 终端进入下载目录，执行安装命令：
sudo apt install 对应的包名.deb； - 安装完成后同样配置
JAVA_HOME环境变量并验证。
非必要不推荐安装，避免版权问题和兼容性问题。
七、常见问题解决
1. java: command not found
原因：未安装 JDK 或环境变量未生效。解决：重新执行安装命令，执行source ~/.bashrc 刷新配置。
2. javac 命令不存在
原因：仅安装了 JRE 运行环境，未安装完整 JDK。解决：安装带 -jdk 后缀的安装包，如 openjdk-17-jdk。
3. 环境变量重启后失效
原因：配置写入文件错误。解决：务必写入 ~/.bashrc，不要写入临时终端配置。
八、总结
1. 日常开发首选 OpenJDK，免费稳定、无版权风险，APT 一键安装最便捷；
2. 优先使用 JDK11/JDK17 LTS 版本，适配绝大多数项目，稳定性拉满；
3. 安装后必须配置 JAVA_HOME，这是后续所有 Java 工具运行的基础；
4. 多版本共存可通过系统命令快速切换，无需重复配置环境。
按照本文步骤操作，即可在 Ubuntu 系统搭建一套完整、可用、稳定的 Java 开发环境，适配学习、开发、服务器部署全场景。
