Java安装教程：Windows、macOS 和 Linux 的安装步骤

安装 Java 时，最重要的不是找到一个名为“Java”的下载按钮，而是确认项目需要哪个版本、安装的是 JDK 还是仅含运行环境的组件，以及命令行实际使用了哪一套 Java。本文介绍 Windows、macOS 和常见 Linux 发行版上的安装方法，并说明如何验证配置、运行示例程序和排查常见问题。

一、安装前先确定版本和用途

JDK、JRE 和 JVM 有什么区别

• JVM 是执行 Java 字节码的虚拟机。
• 运行环境包含运行 Java 程序所需的组件。旧资料常把它称作 JRE。现代 JDK 发行版通常自带运行所需的组件，但不一定单独提供传统意义上的 JRE 安装包。
• JDK 是 Java 开发工具包，除运行组件外，还包含编译器 javac 等开发工具。需要编译代码、运行构建工具或学习 Java 时，应安装 JDK。

只需运行某个 Java 应用时，先查看应用厂商的要求；不少桌面应用会自带运行时。若应用要求系统 Java，则按其指定版本安装。不要仅凭“装了 Java”就假设系统中已有 javac。

选择 Java 版本

先检查项目的构建文件、部署说明和运行平台要求。项目指定 Java 17，就不要因为 Java 21 或更高版本更新而擅自切换。新项目可以优先考虑仍在维护的 LTS（长期支持）版本，但“LTS”不代表所有发行版、供应商和平台的支持期限都相同，应查看实际发行版的支持政策。Java 8、11、17、21 等版本仍可能出现在现有项目中；版本是否适用取决于项目和供应商支持情况。

Java 规范与具体 JDK 发行版不是一回事。OpenJDK 项目提供开源实现，不同供应商也会构建和发布各自的 JDK。选择发行版时，确认操作系统、CPU 架构、许可条款、更新政策及组织要求。个人开发者可使用可信供应商发布的 OpenJDK 构建，也可以使用 Oracle JDK；两者的许可与分发条件不能一概而论，应阅读对应版本的许可说明。

确认操作系统与架构

下载图形安装包或选择包管理器包之前，确认设备使用 Windows、macOS 还是 Linux，以及处理器架构。常见架构名称包括 x64（Intel/AMD 64 位）和 ARM64/AArch64。macOS 的 Apple 芯片与 Intel 芯片所需安装包不同；Linux 容器或远程服务器也可能与本机架构不同。

二、Windows 安装 Java

方法一：使用安装程序

1. 从所选 JDK 供应商的官方网站进入下载页面，选择所需 Java 主版本、Windows 和正确架构的安装包。优先使用供应商提供的安装程序或压缩包，不要从不明下载站获取安装文件。
2. 运行安装程序，按提示完成安装。记下安装目录，例如 C:\Program Files\Java\jdk-21；实际目录以安装结果为准，不要照抄示例路径。
3. 打开新的“命令提示符”或 PowerShell 窗口，执行：

java -version
javac -version

java -version 用于查看 Java 运行命令的版本，javac -version 用于确认编译器是否可用。输出的主版本应符合项目要求。若提示命令无法识别，继续检查环境变量。

配置 JAVA_HOME 和 PATH

安装程序有时会自动配置 PATH，有时不会。可在 Windows 设置中搜索“编辑系统环境变量”，打开“环境变量”，在需要使用的用户变量或系统变量中新增或修改：

• JAVA_HOME：指向 JDK 根目录，例如 C:\Program Files\Java\jdk-21。不要把它设为 ...\bin，也不要包含引号。
• Path：增加 %JAVA_HOME%\bin。

保存后关闭并重新打开终端，再执行：

echo %JAVA_HOME%
where java
where javac
java -version
javac -version

where java 会列出 PATH 中可找到的命令位置。如果列出多个路径，系统通常使用 PATH 中优先匹配的那个。旧版 JDK、其他工具或 Windows 的应用执行别名都可能影响实际结果。检查输出路径，并调整 PATH 顺序或移除不需要的旧路径。仅修改环境变量而不重开终端，旧终端通常不会获得新值。

PowerShell 中也可以这样查看：

$env:JAVA_HOME
Get-Command java -All

不熟悉系统环境变量时，不要覆盖整条 PATH。只添加或调整需要的项目，并保留其他程序所需的条目。

方法二：使用 winget

如果系统安装了 Windows Package Manager（winget），可以先搜索可用软件包：

winget search OpenJDK

确认软件包名称、来源和版本后，使用搜索结果中的精确包标识安装，例如：

winget install --id Microsoft.OpenJDK.21 --exact

包管理器中的标识和可用版本可能随仓库变化。若上述标识无法找到，不要猜测另一个包名；以本机 winget search 的结果和对应发行方说明为准。包管理器也不保证自动解决多版本冲突，安装后仍应检查 where java 和 java -version。

三、macOS 安装 Java

方法一：使用供应商安装包

1. 确认 Mac 的芯片类型：打开苹果菜单中的“关于本机”，查看处理器或芯片信息。选择匹配 Intel 或 Apple 芯片的 JDK 安装包。
2. 从供应商官方网站下载 macOS 安装包并按提示安装。若供应商提供签名或校验值，可按其文档验证下载文件；不要通过关闭系统安全功能来绕过来源检查。
3. 打开新的“终端”，检查：

java -version
javac -version
/usr/libexec/java_home -V

/usr/libexec/java_home -V 用于列出系统发现的 Java 安装。若机器上有多套 JDK，查看输出有助于确认版本和安装位置。

配置 JAVA_HOME

macOS 通常能通过 /usr/libexec/java_home 找到已安装的 JDK。当前终端可这样设置某个主版本的路径：

export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH="$JAVA_HOME/bin:$PATH"
java -version
javac -version

这里的 21 是示例版本，应替换为已安装且项目需要的版本。要让配置在之后打开的 zsh 终端中持续生效，可将这两行写入 ~/.zshrc，然后执行 source ~/.zshrc。如果使用 bash，应修改相应的 bash 启动文件。某些 GUI 应用不会读取交互式 shell 的配置文件，因此终端中的 JAVA_HOME 不一定能影响 GUI 应用；这类应用应按照其自身文档配置。

方法二：使用 Homebrew

已安装 Homebrew 的用户，可先查看可用公式：

brew search openjdk

例如安装 OpenJDK 21：

brew install openjdk@21

Homebrew 的公式名称和支持情况可能变化，先以 brew search 结果为准。版本化公式可能需要额外配置符号链接或环境变量，具体做法以安装输出中的提示为准；不要为省事随意覆盖系统目录。安装后运行 java -version、javac -version，并用 /usr/libexec/java_home -V 核对系统是否发现该 JDK。

四、Linux 安装 Java

Linux 上的命令取决于发行版、软件仓库和版本。优先使用发行版官方仓库或组织批准的仓库；包名和可用主版本可能不同。以下命令展示常见形式，执行前应确认目标软件包确实对应所需版本。

Ubuntu 或 Debian

更新软件包索引并安装 JDK。下面以仓库提供 Java 21 为例：

sudo apt update
sudo apt install openjdk-21-jdk
java -version
javac -version

如果提示找不到软件包，先查看发行版版本及仓库中可用的包，不要直接从陌生站点下载压缩包。某些系统仓库没有该主版本，可选择发行版支持的版本，或按可信 JDK 供应商针对该发行版的官方说明配置来源。

Fedora、RHEL 系发行版

Fedora 常见安装形式如下：

sudo dnf install java-21-openjdk-devel
java -version
javac -version

软件包名称会因发行版和版本变化。RHEL、Rocky Linux、AlmaLinux 等系统的仓库配置及可用包并不完全相同，应先用包管理器查询，并遵循组织的仓库策略。例如，可使用发行版提供的搜索功能确认包名，再安装对应的开发包。安装 -devel 或其他开发工具包的目的，是确保获得编译器等开发工具；仅运行程序时所需的包可能不同。

Arch Linux

Arch Linux 可在已启用并同步的仓库中查询可用 JDK，再安装适合项目的包。包名会随仓库状态变化，先执行：

pacman -Ss openjdk

根据搜索结果选择需要的主版本和包，再使用 sudo pacman -S 包名 安装。不要把其他发行版的 apt 或 dnf 命令直接用于 Arch。

查看与切换多套 Java

Linux 系统可能同时装有多个 JDK。Debian 系发行版可查看候选命令：

update-alternatives --list java
update-alternatives --list javac

如需切换，可运行系统提供的交互选择命令：

sudo update-alternatives --config java
sudo update-alternatives --config javac

切换 java 和 javac 时要确保两者来自同一套兼容的 JDK。其他发行版可能使用不同的 alternatives 工具或切换机制；不要假设上述命令在所有 Linux 上都存在。切换后新开终端并检查 java -version、javac -version 和实际命令路径。

五、编写并运行一个 Java 程序

确认 JDK 可用后，可以用下面的最小示例验证编译和运行流程。将文件保存为 HelloJava.java：

public class HelloJava {
    public static void main(String[] args) {
        System.out.println("Java 已安装并可以运行。");
    }
}

进入文件所在目录，在终端执行：

javac HelloJava.java
java HelloJava

第一条命令会生成 HelloJava.class；第二条命令运行类名为 HelloJava 的程序。运行命令中通常不写 .class 后缀。成功时会打印：

Java 已安装并可以运行。

使用较新的 JDK 时，也可以尝试直接运行单文件源代码：

java HelloJava.java

该用法适合简单程序，不等同于完整的项目构建流程。大型项目仍应使用项目采用的构建工具，并遵循其编译目标和依赖配置。不同 Java 版本和工具链对单文件启动等功能的支持可能不同；如果命令不支持，使用 javac 编译方式即可。

六、常见问题与排查顺序

提示“不是内部或外部命令”“command not found”

这通常表示当前终端找不到命令。先检查 JDK 是否安装，再确认 JDK 的 bin 目录已加入 PATH。Windows 使用 where java，macOS 和 Linux 使用 which java 或 command -v java 查看命令路径。修改环境变量后要新开终端；路径中不要误把 JAVA_HOME 本身设置为 bin 子目录。

java 有版本，javac 却找不到

可能只安装了运行组件、PATH 指向另一套安装，或系统中存在不完整的旧配置。安装与项目匹配的 JDK，检查 JAVA_HOME 和 javac 实际路径。不要通过从另一台机器拷贝一个 javac 文件来修补安装。

版本号不符合项目要求

电脑上可能存在多个 Java，且 PATH 的先后顺序决定命令优先使用哪一个。在 Windows 检查 where java；macOS 检查 /usr/libexec/java_home -V；Linux 检查发行版的包管理及 alternatives 配置。然后按项目文档调整命令搜索顺序或构建工具配置。仅设置 JAVA_HOME 不一定会自动改变所有程序实际调用的 java。

系统命令与 IDE 使用了不同版本

IDE 可以配置自己的 JDK，构建工具也可能通过环境变量、工具链配置或项目设置指定版本。分别检查 IDE 的项目 SDK、构建工具的 Java 配置和终端中的 java -version。终端验证通过，并不能保证 IDE 或后台服务也会使用同一套 JDK。

应用提示版本不兼容

需要区分“用于运行构建工具的 JDK”和“编译输出的目标版本”。项目可能要求特定 JDK 才能运行构建工具，也可能通过构建配置生成面向较旧 Java 版本的字节码。不要仅凭错误提示安装任意最新版；对照项目要求检查 JDK 主版本、编译目标和依赖兼容性。

安装包打不开或架构不匹配

检查操作系统版本、CPU 架构和安装包格式。macOS Intel 安装包不能替代 Apple 芯片版本，Linux 的 ARM64 包也不能直接安装到 x64 机器。若系统提示安装程序来源无法验证，应确认下载来源和签名，而不是关闭系统保护后继续安装不明文件。

容器、服务和远程任务找不到 Java

容器里的环境变量和文件系统与宿主机可能隔离；本机已安装 JDK，不表示容器中也有。服务进程也可能读取不同的启动环境。检查实际运行进程的镜像、服务配置、PATH 和 JAVA_HOME，并确认部署环境中包含符合要求的运行时。不要把本机的环境变量设置当作容器或服务器的配置。

七、安全与维护注意事项

• 从可信来源安装：使用发行版官方仓库、JDK 供应商官方网站或组织批准的软件仓库。第三方下载站上的同名安装包不一定可信。
• 保持安全更新：JDK 更新可能修复安全问题。生产环境应按组织的变更流程更新，并在测试环境验证兼容性；不要长期运行已停止维护且存在已知风险的版本。
• 核对校验信息：若供应商提供校验和或签名，可按其官方步骤验证。校验和应从可信渠道取得；单独下载一个校验文件并不能证明来源可信。
• 不要把 JAVA_HOME 当作密钥：JAVA_HOME 只是一个本地路径，通常不含密码或令牌。不要把秘密写进 shell 配置、构建脚本或公开仓库；环境变量也不应被视为对所有进程都保密的存储方式。
• 安装 Java 不等于获得安全沙箱：现代 Java 程序通常以当前用户权限运行。安装 JDK 不会自动隔离不可信程序，也不应把运行未经审查的代码视为安全。不要依赖已废弃的浏览器插件或过时的安全机制来保护应用。
• 生产系统按需安装：只需要运行应用时，优先依据应用供应商说明选择合适的运行环境，不必默认在生产服务器安装完整开发工具链。若安装 JDK，确保其更新策略和访问权限符合系统管理要求。

八、安装完成检查清单

1. 已确认项目要求的 Java 主版本、发行版和处理器架构。
2. 需要开发时安装了 JDK，而不只是运行组件。
3. java -version 显示符合要求的版本。
4. javac -version 可用，并与预期的 JDK 匹配。
5. 已检查 JAVA_HOME 和命令实际路径，排除旧版本抢先匹配。
6. 已编译并运行示例程序；若使用 IDE、容器或服务，也单独核对了它们采用的 Java。

做到以上几点，通常就能完成个人开发机上的 Java 安装与基本验证。多版本项目或生产环境还需要进一步遵循项目锁定的 JDK、构建工具和更新策略，而不是只依赖系统默认版本。