构建与依赖 / 系统课时

安装 JDK 与 Maven

安装 JDK 与 Maven

本节把 JDK 与 Maven 安装到可用状态,并让新终端指向正确版本。完成后应能执行 java、javac 和 mvn,同时知道 JAVA_HOME、Maven 安装目录与 Path 分别应该指向哪里。

学习目标

  • 选择一组可长期使用的 JDK 与 Maven 版本,并区分 JDK 根目录和 bin 目录。
  • 在 Windows、macOS 或 Linux 上完成 Maven 解压与环境变量配置。
  • 用命令验证 Java 编译器和 Maven 都来自预期安装目录。

选择版本与目录

本课用 JDK 21 + Maven 3.10.0 作为演示基线。Maven 3.10.x 运行本身只要求 Java 8 及以上,但项目实际编译版本由项目配置决定;学习阶段统一到 JDK 21,可以减少“终端是一个 JDK、IDE 又是另一个 JDK”的干扰。

建议把工具目录固定下来,不要直接放进下载目录。Windows 可使用 C:\Dev\jdk-21 与 C:\Dev\apache-maven-3.10.0;Linux 可使用 /opt/jdk-21 与 /opt/apache-maven-3.10.0;macOS 的 JDK 通常由安装器放在 /Library/Java/JavaVirtualMachines/ 下,Maven 可放在 $HOME/tools/。

安装并确认 JDK

安装 JDK 21 后先只验证 Java,不急着配置 Maven。Windows、macOS 和 Linux 都使用相同的检查命令;若系统同时存在多个 JDK,先确认 javac 也能被识别,因为只有 JRE 时通常没有 Java 编译器。

bash
java -version
javac -version

预期输出:

text
openjdk version "21.0.<PATCH>" <DATE> LTS
...
javac 21.0.<PATCH>

补丁号、发布日期和供应商文本会随发行版不同。如果 java 能执行但 javac 找不到,优先检查是否装成了仅运行时环境,或 Path 仍指向旧 Java 目录。

安装 Maven 并配置环境变量

从 Apache Maven 的二进制发行包解压后,Maven 根目录下应能看到 bin、boot、conf、lib 等目录。不要下载 src 源码包来当作可执行发行包;真正需要加入 Path 的是 apache-maven-3.10.0/bin。

Windows 10/11 可按以下路径配置:打开“系统属性”→“高级”→“环境变量”,在用户变量中新增 JAVA_HOME 和 MAVEN_HOME,再编辑用户 Path,加入 %JAVA_HOME%\bin 与 %MAVEN_HOME%\bin。修改后必须关闭旧终端并重新打开,因为已经启动的进程不会自动读取新环境变量。

Linux 的 Shell 配置可以写入 ~/.bashrc;macOS 默认 zsh 可写入 ~/.zshrc。下面是 Linux 手动解压场景的片段示例,实际路径按安装位置替换。

bash
export JAVA_HOME="<PATH>/jdk-21"
export MAVEN_HOME="<PATH>/apache-maven-3.10.0"
export PATH="$JAVA_HOME/bin:$MAVEN_HOME/bin:$PATH"

保存后重新打开终端,或执行 source ~/.bashrc 让当前 shell 重新加载配置。macOS 如果通过系统 JDK 安装器安装 JDK 21,可把 JAVA_HOME 设置为 /usr/libexec/java_home -v 21 的返回目录,而不是手写带补丁号的目录名。

验证 Maven 是否接到了正确 JDK

新开一个终端后同时检查 Java 和 Maven。mvn -v 不只是看 Maven 版本,它还会显示 Maven 实际使用的 Java 版本、运行时路径和操作系统信息,因此比单独执行 mvn 更适合作为安装验收。

bash
java -version
mvn -v

预期输出:

text
openjdk version "21.0.<PATCH>" <DATE> LTS
...
Apache Maven 3.10.0 (<HASH>)
Maven home: <PATH>
Java version: 21.0.<PATCH>, vendor: <VENDOR>, runtime: <PATH>
Default locale: <LOCALE>, platform encoding: UTF-8
OS name: "<OS>", version: "<VERSION>", arch: "<ARCH>", family: "<FAMILY>"

这里最需要核对两处:Maven home 应是刚刚解压的 Maven 目录,runtime 应位于目标 JDK 21 下。如果版本正确但路径不是预期值,说明机器上还有旧安装通过 Path 抢在了前面。

处理最常见的安装失败

出现“找不到 mvn”时,不要反复重装,先检查 Maven 的 bin 是否真的进入了新终端的 Path。Windows 可用 where.exe mvn,macOS/Linux 可用 which -a mvn;若返回多个路径,排在第一位的就是当前优先执行的版本。

出现 JAVA_HOME is not defined correctly 一类错误时,直接检查 JAVA_HOME 指向的目录里是否存在 bin/java 与 bin/javac。如果只存在 Java 运行命令、没有编译器,或目录多写了一层 bin,都应先修正环境变量,再重新打开终端验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 JDK 与 Maven

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通