Java 后端 / 系统课时

搭建 Java 21 与 Maven 环境

搭建 Java 21 与 Maven 环境

本课完成企业级 Spring Boot 3 开发所需的基础工具链:安装并固定 Java 21、配置 Maven 3.9+、确认 Git 与开发工具可用,最后通过一个最小 Java 项目验证编译和运行链路。

学习目标

  • 正确设置 JAVA_HOME、PATH 与 Maven 命令环境
  • 使用版本命令确认 Java 21、Maven 3.9+ 和 Git 均已生效
  • 创建并构建最小项目,排除“命令可用但编译链路不可用”的问题

确定工具链基线

Spring Boot 3 项目应使用完整 JDK,而不是只安装 JRE。统一团队基线时,将 Java 主版本固定为 21,Maven 固定为 3.9 或更高版本,并让 IDE、终端和持续集成环境使用同一套版本。

建议准备 Java 21 JDK、Apache Maven 3.9+、Git 2.x,以及支持 Java 21 的 IntelliJ IDEA、VS Code 或 Eclipse。安装目录尽量避免空格、中文和临时下载路径,便于后续脚本与构建工具稳定引用。

配置 Java 21

从 JDK 发行方或操作系统包管理器安装 Java 21 后,将 JAVA_HOME 指向 JDK 根目录,而不是 bin 目录。下面是 macOS 或 Linux 终端中的配置与验证方式;请把占位路径替换为本机真实目录。

bash
export JAVA_HOME="<PATH_TO_JDK_21>"
export PATH="$JAVA_HOME/bin:$PATH"

java -version
javac -version

预期输出

text
openjdk version "21.<MINOR>" <TIME>
OpenJDK Runtime Environment ...
OpenJDK 64-Bit Server VM ...
javac 21.<MINOR>

补丁号、构建号和时间会随发行版不同而变化,但主版本必须为 21。需要永久生效时,将前两行写入当前 Shell 的启动文件,例如 ~/.zshrc 或 ~/.bashrc,然后重新打开终端。

Windows 可在“用户环境变量”中创建 JAVA_HOME=<PATH_TO_JDK_21>,并在 Path 中加入 %JAVA_HOME%\bin。重新打开 PowerShell 后执行相同的版本检查,确认结果指向 Java 21。

配置 Maven 与 Git

下载并解压 Apache Maven 3.9+ 后,将 Maven 的 bin 目录加入 PATH。MAVEN_HOME 不是 Maven 运行的硬性要求,但企业脚本和部分 IDE 仍会读取它,因此可以一并设置。

bash
export MAVEN_HOME="<PATH_TO_MAVEN>"
export PATH="$MAVEN_HOME/bin:$PATH"

mvn -version
git --version

预期输出

text
Apache Maven 3.9.<MINOR> (...)
Maven home: <PATH_TO_MAVEN>
Java version: 21.<MINOR>, vendor: ...
Java home: <PATH_TO_JDK_21>
git version 2.<MINOR>.<PATCH>

检查重点是 Maven 显示的 Java version 与 Java home。如果终端中的 Java 是 21,而 Maven 仍显示旧版本,通常是 Maven 进程继承了错误的 JAVA_HOME,需要修正环境变量并重启终端或 IDE。

构建最小验证项目

仅验证版本命令不足以证明编译链路完整。新建目录 env-check,在根目录创建以下 pom.xml,明确要求 Maven 使用 Java 21 编译。

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>env-check</artifactId>
    <version>1.0.0</version>

    <properties>
        <maven.compiler.release>21</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
</project>

创建 src/main/java/com/example/EnvCheck.java。这个类会打印实际运行时版本,用于确认编译与执行都没有回退到旧 JDK。

java
package com.example;

public class EnvCheck {
    public static void main(String[] args) {
        System.out.println("Java runtime: " + Runtime.version());
        System.out.println("Environment ready");
    }
}

在项目根目录执行构建并运行编译结果。

bash
mvn -q clean package
java -cp target/classes com.example.EnvCheck

预期输出

text
Java runtime: 21.<MINOR>...
Environment ready

首次构建需要从 Maven Central 下载插件,耗时取决于网络环境。若出现证书、代理或仓库访问错误,应先处理 Maven 网络配置,而不是反复重装 JDK。

检查 IDE 与版本控制

在 IDE 中打开 env-check,确认项目 SDK、语言级别和 Maven Runner 都使用 Java 21。IDE 内置 Maven 可以使用,但团队开发更推荐指向统一安装的 Maven 3.9+,避免成员之间出现构建差异。

初始化 Git 仓库并确认工作区状态。

bash
git init
git status --short

预期输出

text
Initialized empty Git repository in <PATH>/.git/
?? pom.xml
?? src/

不同 Git 版本的初始化提示可能略有差异。正式项目还应配置用户名与邮箱,并将 IDE 配置目录、target 构建产物和本地密钥加入 .gitignore,不要提交个人路径或凭据。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建 Java 21 与 Maven 环境

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

登录哪都通