Java 21 实战准备

在开始编写代码之前，我们需要配置好开发环境。本节将指导你完成 Java 21 开发环境的配置，包括 JDK 安装、IDE 配置、Maven 配置，以及环境验证。

本节将学习：JDK 安装配置、IDE 配置（推荐使用 IntelliJ IDEA）、Maven 配置，以及验证环境。

JDK 安装配置

JDK 下载

Java 21 JDK 下载地址：

Oracle JDK：
- 下载地址：https://www.oracle.com/java/technologies/downloads/#java21
- 需要 Oracle 账号（免费注册）
OpenJDK：
- 下载地址：https://jdk.java.net/21/
- 无需账号，直接下载
其他发行版：
- Eclipse Temurin：https://adoptium.net/
- Amazon Corretto：https://aws.amazon.com/corretto/
- Microsoft Build of OpenJDK：https://www.microsoft.com/openjdk

安装步骤

Windows 系统

步骤：

下载 JDK 安装包（.msi 或 .exe 文件）
运行安装程序，按照向导完成安装
设置环境变量：
- JAVA_HOME：JDK 安装路径（如：C:\Program Files\Java\jdk-21）
- PATH：添加 %JAVA_HOME%\bin
验证安装：
```
java -version
javac -version
```

macOS 系统

使用 Homebrew 安装：

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Java 21
brew install openjdk@21

# 设置 JAVA_HOME
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 21)' >> ~/.zshrc
source ~/.zshrc

验证安装：

java -version
javac -version

Linux 系统（Ubuntu/Debian）

# 更新包列表
sudo apt update

# 安装 OpenJDK 21
sudo apt install openjdk-21-jdk

# 设置默认 Java 版本
sudo update-alternatives --config java

# 验证安装
java -version
javac -version

环境变量配置

Windows 环境变量：

# 设置 JAVA_HOME
setx JAVA_HOME "C:\Program Files\Java\jdk-21"

# 添加到 PATH
setx PATH "%PATH%;%JAVA_HOME%\bin"

macOS/Linux 环境变量：

# 编辑 ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk
export PATH=$PATH:$JAVA_HOME/bin

IDE 配置：推荐使用 IntelliJ IDEA

IntelliJ IDEA 下载

推荐使用 IntelliJ IDEA（Community 版本或正式版本均可）：

Community 版本（免费）：
- 下载地址：https://www.jetbrains.com/idea/download/
- 功能：支持 Java 开发，满足课程需求
Ultimate 版本（付费，有免费试用）：
- 下载地址：https://www.jetbrains.com/idea/download/
- 功能：支持更多框架和工具

IntelliJ IDEA 配置

配置步骤：

配置 Project SDK：
- File → Project Structure → Project
- 设置 Project SDK 为 Java 21
- 设置 Project language level 为 21
配置 Maven：
- File → Settings → Build, Execution, Deployment → Build Tools → Maven
- 设置 Maven home directory
- 设置 User settings file
安装插件（可选）：
- Lombok Plugin
- Spring Boot Plugin
- MyBatis Plugin

创建第一个项目

步骤：

File → New → Project
选择 Java，设置 Project SDK 为 Java 21
选择 Maven 作为构建工具
输入项目名称和位置
点击 Finish

Maven 配置

Maven 下载

Maven 下载地址：

官方网站：https://maven.apache.org/download.cgi
下载 apache-maven-3.9.x-bin.zip（或对应平台的压缩包）

Maven 安装

Windows 系统

解压 Maven 到目录（如：C:\Program Files\Apache\maven）
设置环境变量：
- MAVEN_HOME：Maven 安装路径
- PATH：添加 %MAVEN_HOME%\bin
验证安装：
```
mvn -version
```

macOS/Linux 系统

# 下载并解压
wget https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
tar -xzf apache-maven-3.9.6-bin.tar.gz
sudo mv apache-maven-3.9.6 /opt/maven

# 设置环境变量
export MAVEN_HOME=/opt/maven
export PATH=$PATH:$MAVEN_HOME/bin

# 验证安装
mvn -version

Maven 配置优化

配置 Maven 镜像（加速下载）：

编辑 ~/.m2/settings.xml（如果不存在则创建）：

<?xml version="1.0" encoding="UTF-8"?>
<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>aliyun</id>
            <mirrorOf>central</mirrorOf>
            <name>Aliyun Maven</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>

环境验证

验证检查清单

验证命令

1. 验证 JDK：

# 检查 Java 版本
java -version
# 应该显示：openjdk version "21" 或 java version "21"

# 检查 Java 编译器
javac -version
# 应该显示：javac 21

2. 验证 Maven：

# 检查 Maven 版本
mvn -version
# 应该显示：Apache Maven 3.9.x 和 Java version: 21

3. 验证环境变量：

Windows：

echo %JAVA_HOME%
echo %MAVEN_HOME%

macOS/Linux：

echo $JAVA_HOME
echo $MAVEN_HOME

创建测试项目

使用 Maven 创建测试项目：

# 创建 Maven 项目
mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=java21-test \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false

# 进入项目目录
cd java21-test

# 编译项目
mvn compile

# 运行项目
mvn exec:java -Dexec.mainClass="com.example.App"

在 IntelliJ IDEA 中验证：

创建新项目
选择 Java 21 作为 SDK
创建简单的 Hello World 类
运行程序，确认可以正常执行

常见问题

问题1：java -version 显示旧版本

解决方案：

检查 PATH 环境变量，确保 Java 21 的路径在前面
重新打开终端/命令行窗口
Windows：检查系统环境变量和用户环境变量

问题2：Maven 找不到 Java

解决方案：

确保 JAVA_HOME 环境变量正确设置
检查 Maven 的 mvn 脚本中的 JAVA_HOME 引用
重新安装 Maven

问题3：IntelliJ IDEA 找不到 Java 21

解决方案：

File → Project Structure → SDKs → 添加 JDK
选择 Java 21 的安装路径
确保 Project SDK 设置为 Java 21

官方资源

Java 21 下载：https://www.oracle.com/java/technologies/downloads/#java21
IntelliJ IDEA 下载：https://www.jetbrains.com/idea/download/
Maven 下载：https://maven.apache.org/download.cgi
Maven 安装指南：https://maven.apache.org/install.html

本节小结

在本节中，我们完成了：

第一个是 JDK 安装配置。 下载并安装 Java 21，配置 JAVA_HOME 环境变量。

第二个是 IDE 配置。 安装并配置 IntelliJ IDEA，设置 Java 21 作为 Project SDK。

第三个是 Maven 配置。 下载并安装 Maven，配置镜像加速下载。

第四个是环境验证。 验证所有工具是否正确安装和配置。

这就是 Java 21 实战准备。完成这些配置后，我们就可以开始编写代码了。

在下一章，我们将学习 Spring 6 和 Spring Boot 3 的基础知识，了解 Spring 生态的最新特性。