🧩 一、全局环境变量配置（推荐系统级统一）

⚙️ 二、Maven全局配置（多项目统一）

📂 三、项目级配置（推荐团队协作）

💻 四、IDE配置（辅助验证）

🧪 五、验证配置生效

⚠️ 六、常见问题解决

💎 七、配置方案对比

以下是Java项目中配置Maven使用JDK 1.8的完整方案，结合不同场景提供多种方法并附操作示例：

🧩 一、全局环境变量配置（推荐系统级统一）

适用场景：所有Maven项目均需使用JDK 1.8时
操作步骤：

设置JAVA_HOME环境变量
- Windows：
  - 控制面板 → 系统 → 高级系统设置 → 环境变量 → 新建系统变量：
```
变量名：JAVA_HOME
变量值：C:\Program Files\Java\jdk1.8.0_301  # 替换为实际安装路径
```
  - 编辑Path变量 → 新增%JAVA_HOME%\bin
- Linux/macOS：
  编辑~/.bashrc或~/.zshrc，添加：
```
export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_301  # 替换实际路径
export PATH=$JAVA_HOME/bin:$PATH
```
  执行source ~/.bashrc生效。

验证配置
命令行执行：

mvn -version

输出应包含：

Java version: 1.8.0_301  # 确认JDK版本

⚙️ 二、Maven全局配置（多项目统一）

适用场景：需统一管理多个项目的JDK版本
操作步骤：

修改settings.xml文件（路径：Maven安装目录/conf/settings.xml或~/.m2/settings.xml）

添加以下配置：

<settings><profiles><profile><id>jdk-1.8</id><activation><activeByDefault>true</activeByDefault>  <!-- 默认激活 --><jdk>1.8</jdk>  <!-- 指定JDK版本 --></activation><properties><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target></properties></profile></profiles>
</settings>

📂 三、项目级配置（推荐团队协作）

适用场景：确保项目在任意环境编译一致性
方法1：通过<properties>标签配置（简洁版）
在pom.xml中添加：

<properties><java.version>1.8</java.version><maven.compiler.source>${java.version}</maven.compiler.source><maven.compiler.target>${java.version}</maven.compiler.target>
</properties>

方法2：显式配置maven-compiler-plugin（精细控制）

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version>  <!-- 推荐稳定版本 --><configuration><source>1.8</source><target>1.8</target><!-- 可选：解决模块化兼容问题 --><compilerArgs><arg>--add-opens=java.base/java.lang=ALL-UNNAMED</arg></compilerArgs></configuration></plugin></plugins>
</build>

💻 四、IDE配置（辅助验证）

IntelliJ IDEA操作：

项目JDK设置：
File → Project Structure → Project SDK → 选择JDK 1.8
Maven导入设置：
Settings → Build Tools → Maven → Importing → 设置JDK for importer为JDK 1.8

Eclipse操作：

项目右键 → Properties → Java Build Path → Libraries → 添加JDK 1.8
Java Compiler → Compiler compliance level → 设为1.8

🧪 五、验证配置生效

命令行验证：

mvn clean compile -X | grep "Source compatibility"

输出应显示：

[DEBUG] Source compatibility: 1.8
[DEBUG] Target compatibility: 1.8

代码级验证：
在项目中添加JDK 1.8特性（如Lambda表达式）：
```
Runnable r = () -> System.out.println("JDK 1.8生效！");
```
编译通过即配置成功。

⚠️ 六、常见问题解决

问题现象	解决方案
编译报错`不支持发行版本XX`	检查`pom.xml`和`settings.xml`中`<source>/<target>`值是否为1.8
IDE与Maven版本不一致	在IDE中强制指定Maven配置路径（如IDEA的`User settings file`）
旧插件不兼容JDK 1.8	升级插件版本（如`maven-compiler-plugin`≥3.8.1）
环境变量未生效	重启终端/IDE，或执行`mvn help:system`查看实际JAVA_HOME值

💎 七、配置方案对比

方法	适用场景	优先级	优点
系统环境变量(`JAVA_HOME`)	单机全局统一	★★★	简单直接，影响所有工具链
Maven全局配置(`settings.xml`)	多项目统一管理	★★☆	避免单项目重复配置
项目级配置(`pom.xml`)	团队协作保证一致性	★★★	代码化配置，版本可控
IDE配置	开发环境辅助	★☆☆	快速验证，不改变构建结果