目录
- 准备工作
- 使用包管理器安装 (推荐新手)
- 基于 Debian/Ubuntu (使用
apt) - 基于 CentOS/RHEL/Fedora (使用
yum或dnf)
- 基于 Debian/Ubuntu (使用
- 手动安装 (推荐更灵活的控制)
- 使用 SDKMAN! 安装 (推荐多版本管理)
- 验证 Java 安装
- 配置环境变量 (重要)
- 搭建项目构建工具:Maven
- 搭建集成开发环境:IntelliJ IDEA
- 总结与最佳实践
准备工作
在开始之前,请确保你已经:

- 安装了 Linux 操作系统:本指南适用于主流发行版,如 Ubuntu, Debian, CentOS, Fedora, Mint 等。
- 拥有管理员权限:安装软件通常需要
sudo权限。 - 更新了软件包列表:这是一个好习惯,可以确保你安装的是最新版本的软件。
- 对于
apt(Debian/Ubuntu):sudo apt update - 对于
dnf(Fedora/CentOS 8+):sudo dnf check-update - 对于
yum(CentOS 7):sudo yum check-update
- 对于
方式一:使用包管理器安装 (最简单)
这是最简单、最快速的方式,适合新手,包管理器会自动处理依赖关系。
A. 基于 Debian/Ubuntu (使用 apt)
-
安装 OpenJDK 17
# 安装 OpenJDK 17 JDK (Java Development Kit) sudo apt install openjdk-17-jdk # 如果你只需要 JRE (Java Runtime Environment) 来运行程序,可以安装 openjdk-17-jre # sudo apt install openjdk-17-jre
-
(可选) 安装设置工具 这个工具可以自动帮你配置
JAVA_HOME环境变量。sudo apt install installtion
安装后,运行
sudo update-java-alternatives --set /usr/lib/jvm/java-17-openjdk-amd64(路径可能不同,请根据实际情况调整)。
(图片来源网络,侵删)
B. 基于 CentOS/RHEL/Fedora (使用 yum 或 dnf)
- 安装 OpenJDK 17
- 对于 Fedora / CentOS 8+ (使用
dnf):sudo dnf install java-17-openjdk-devel
- 对于 CentOS 7 (使用
yum):sudo yum install java-17-openjdk-devel
java-17-openjdk-devel包包含了javac(编译器),所以安装它就相当于安装了完整的 JDK。
- 对于 Fedora / CentOS 8+ (使用
方式二:手动安装 (更灵活)
当你需要安装特定版本(如 Oracle JDK)或者包管理器没有你想要的版本时,手动安装是更好的选择,我们以安装 OpenJDK 17 为例。
-
下载 JDK 访问 Eclipse Temurin (Adoptium) 官网 或 Oracle 官网 下载适用于 Linux 的
.tar.gz压缩包,这里以 Eclipse Temurin 为例。 -
上传并解压
- 将下载的文件(
OpenJDK17U-jdk_x64_linux_hotspot_17.0.8_7.tar.gz)上传到你的 Linux 服务器的/opt目录(这是一个存放可选软件的标准目录)。 - 打开终端,进入
/opt目录并解压:cd /opt sudo tar -xzf OpenJDK17U-jdk_x64_linux_hotspot_17.0.8_7.tar.gz
- 解压后会得到一个类似
jdk-17.0.8+7的文件夹,为了方便,我们给它重命名为一个更简洁的名字:sudo mv jdk-17.0.8+7 jdk-17
- 将下载的文件(
-
配置环境变量 (关键步骤) 手动安装后,必须手动配置环境变量,我们编辑
/etc/profile文件,使所有用户都能使用 Java。
(图片来源网络,侵删)sudo nano /etc/profile
在文件末尾添加以下内容:
# Set Java Environment export JAVA_HOME=/opt/jdk-17 export PATH=$PATH:$JAVA_HOME/bin
JAVA_HOME:指向你 JDK 的安装目录。PATH:将JAVA_HOME/bin目录添加到系统的 PATH 中,这样你就可以在任何地方直接使用java,javac等命令。
-
使配置生效 运行以下命令,让刚才的修改立即生效:
source /etc/profile
或者,你可以注销并重新登录,让系统加载新的环境变量。
方式三:使用 SDKMAN! (管理多版本的最佳选择)
如果你需要在同一台机器上频繁切换不同版本的 Java (项目 A 需要 JDK 8,项目 B 需要 JDK 17),SDKMAN! 是不二之选。
-
安装 SDKMAN!
curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"
-
安装 Java (JDK) SDKMAN! 使用 "Vendor:Version" 的格式,安装 OpenJDK 17:
# 列出所有可用的 Java 版本 sdk list java # 安装一个特定的版本,Eclipse Temurin 17.0.8 sdk install java 17.0.8-tem # 安装完成后,设置为默认版本 sdk default java 17.0.8-tem
-
切换 Java 版本 切换变得异常简单:
# 切换到 JDK 11 sdk use java 11.0.19-tem # 再次查看当前版本 java -version
验证 Java 安装
无论你使用哪种方式安装,最后都需要验证。
-
检查 Java 版本
java -version
如果安装成功,你会看到类似以下的输出:
openjdk version "17.0.8" 2025-07-18 OpenJDK Runtime Environment Temurin-17.0.8+7 (build 17.0.8+7) OpenJDK 64-Bit Server VM Temurin-17.0.8+7 (build 17.0.8+7, mixed mode, sharing) -
检查编译器版本
javac -version
输出应为:
javac 17.0.8 -
检查环境变量 检查
JAVA_HOME和PATH是否正确设置。echo $JAVA_HOME echo $PATH
echo $JAVA_HOME应该输出你设置的 JDK 路径(如/usr/lib/jvm/java-17-openjdk-amd64或/opt/jdk-17)。echo $PATH应该能看到$JAVA_HOME/bin。
配置环境变量 (重要)
如果你发现 java -version 正常,但 echo $JAVA_HOME 为空,或者你的 IDE 无法找到 JDK,说明环境变量没有配置好。
-
为当前用户配置 (推荐) 编辑
~/.bashrc或~/.zshrc文件(取决于你使用的 Shell):nano ~/.bashrc
在文件末尾添加:
export JAVA_HOME=/path/to/your/jdk # /opt/jdk-17 或 /usr/lib/jvm/java-17-openjdk-amd64 export PATH=$PATH:$JAVA_HOME/bin
保存后,运行
source ~/.bashrc使其生效。 -
为所有用户配置 如手动安装部分所述,编辑
/etc/profile,这种方式需要管理员权限,并且对所有用户生效。
搭建项目构建工具:Maven
Maven 用于管理项目依赖、编译、打包、测试等。
-
安装 Maven 使用包管理器最简单:
apt:sudo apt install mavendnf/yum:sudo dnf install maven
-
验证 Maven 安装
mvn -version
你会看到 Maven 和 Java 的版本信息。
-
配置 Maven (可选但推荐) 为了让 Maven 从国内镜像下载依赖,速度更快,可以修改其配置文件。 创建或编辑
~/.m2/settings.xml文件:<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <mirrors> <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror> </mirrors> </settings>
搭建集成开发环境:IntelliJ IDEA
IDEA 是目前最流行的 Java IDE。
-
下载 IDEA 访问 JetBrains IDEA 官网,下载 Community (社区版),它对个人开发者完全免费。
-
安装 IDEA
- 图形界面安装:下载的通常是
.tar.gz文件,右键点击,选择“提取到此处”,进入解压后的bin目录,双击idea.sh即可运行。 - 命令行安装:
# 进入下载目录 cd ~/Downloads # 解压 tar -xzf ideaIC-*.tar.gz # 移动到 /opt sudo mv idea-IC-* /opt/intellij-idea # 创建桌面快捷方式 (可选) # ...
- 图形界面安装:下载的通常是
-
配置 IDEA
- 首次启动:启动 IDEA 后,它会自动检测到你系统已安装的 JDK,如果没有,请手动指定你在步骤 1-5 中安装的 JDK 路径。
- 导入 Maven 项目:
File -> Open,选择一个pom.xml文件所在的目录,IDEA 会自动识别并导入 Maven 项目。 - 配置 Maven:在
File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven中,可以配置 Maven 的settings.xml文件和本地仓库路径。
总结与最佳实践
| 场景 | 推荐方式 | 优点 | 缺点 |
|---|---|---|---|
| 新手入门 / 快速搭建 | 包管理器 (apt/yum) |
最简单,自动处理依赖 | 版本可能不是最新的,多版本管理不便 |
| 需要特定版本 / 无 root 权限 | 手动安装 | 灵活,可控制安装位置 | 需要手动配置环境变量 |
| 多 Java 版本管理 / 专业开发者 | SDKMAN! | 版本切换极其方便,生态好 | 需要额外安装一个工具 |
最佳实践建议:
- 使用 LTS 版本:选择长期支持版本,如 JDK 11, 17, 21,它们更稳定,社区支持更好。
- 使用 SDKMAN!:如果你是开发者,尤其是需要接触多个项目的,花 10 分钟安装 SDKMAN! 会为你节省未来无数的时间。
- 让 IDE 管理 JDK:像 IntelliJ IDEA 这样的现代 IDE 可以独立于系统环境来管理项目所需的 JDK,你可以在 IDE 中为每个项目指定不同的 JDK 版本,这比系统级切换更灵活,但确保系统 PATH 中有一个可用的 JDK 仍然是好习惯。
- 版本控制:将你的
.bashrc或.m2/settings.xml等配置文件纳入 Git 版本控制,方便在新环境中快速复现。
你的 Linux Java 开发环境已经完全搭建好了!可以开始你的 Java 编程之旅了。
