在Java开发中,随着业务规模扩大,把项目拆分成多个模块是常见的做法。多模块项目可以通过统一的构建工具管理依赖与编译流程,让代码结构更清晰。本文以Maven为例,介绍如何从零配置Java环境来支持多模块项目。

一、准备Java运行与开发环境
首先需要在本机安装JDK,并配置好环境变量,使命令行能够识别java与javac命令。
1. 安装JDK
从官方渠道下载对应系统的JDK安装包,安装完成后记住安装路径,例如 Windows 下为 C:Javajdk-17。
2. 配置JAVA_HOME与Path
在系统环境变量中新增 JAVA_HOME,指向JDK安装目录,并在 Path 中添加 %JAVA_HOME%bin。配置完成后可在终端执行以下命令验证:
java -version echo %JAVA_HOME%
二、安装并配置Maven
Maven是Java中常用的多模块构建工具。下载二进制包并解压后,同样需要配置环境变量。
- 设置 MAVEN_HOME 指向解压目录
- 在 Path 中加入 %MAVEN_HOME%bin
验证安装是否成功:
mvn -v
三、创建多模块项目结构
多模块项目通常有一个父模块和若干子模块。父模块使用 packaging 类型为 pom,并在 pom.xml 中通过 modules 标签声明子模块。
1. 父模块pom示例
<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
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.demo</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging>
<modules>
<module>user-module</module>
<module>order-module</module>
</modules>
</project>
2. 子模块pom示例
子模块需要声明 parent 指向父模块,从而继承依赖与插件配置。
<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
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.demo</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0</version>
</parent>
<artifactId>user-module</artifactId>
</project>
四、统一依赖管理
为避免各模块依赖版本冲突,可在父模块中使用 dependencyManagement 统一声明版本。
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>5.3.20</version>
</dependency>
</dependencies>
</dependencyManagement>
五、编译与打包
在父模块根目录执行以下命令,即可对所有子模块依次编译和打包:
mvn clean install
通过上述环境配置与Maven结构定义,Java多模块项目就可以在本地顺利构建和运行。后续新增模块时,只需在父pom的 modules 中登记并在子目录添加对应pom即可。