如何将现有Maven项目转为多模块Maven项目的子模块（Eclipse环境）

Hey there! Let's walk through how to convert your existing char-counter Maven project into a submodule of a multi-module Maven project, specifically using Eclipse 4.16.0, plus I'll cover the general approach that works outside Eclipse too.

Step 1: Create the Parent Maven Project #

• Open Eclipse, go to File > New > Maven Project
• Check "Create a simple project (skip archetype selection)" and click Next
• Fill in your parent project details: GroupId, ArtifactId (e.g., my-multi-module), and make sure Packaging is set to pom (this is critical—parent projects must use pom packaging)
• Click Finish; you'll see the parent project with a pom.xml configured for multi-module use

Step 2: Move char-counter into the Parent's Directory #

• On your file system, copy the entire char-counter project folder into the root directory of your new parent project (e.g., my-multi-module/char-counter)
• Back in Eclipse, right-click the parent project and select Refresh to make Eclipse detect the new subfolder

Step 3: Link the Submodule in the Parent's POM #

• Open the parent project's pom.xml, add a <modules> section if it doesn't exist, and include char-counter as a module:

<modules>
  <module>char-counter</module>
</modules>

• Save the file

Step 4: Update char-counter to Reference the Parent #

• Open char-counter's pom.xml, add a <parent> section at the top (before your existing <groupId> if present):

<parent>
  <groupId>your.parent.groupId</groupId> <!-- Match the parent's GroupId -->
  <artifactId>my-multi-module</artifactId> <!-- Match the parent's ArtifactId -->
  <version>1.0.0</version> <!-- Match the parent's Version -->
</parent>

• Optional but recommended: Remove the groupId and version from char-counter's POM—they'll inherit these values from the parent, keeping your configuration consistent

Step 5: Verify the Setup #

• Right-click the parent project > Maven > Update Project...
• Check "Force Update of Snapshots/Releases" and click OK
• You should now see char-counter nested under the parent project in Eclipse's Project Explorer, and running mvn clean install on the parent will build both projects

If you prefer working from the command line or need a method that works with any IDE, follow these steps:

1. Create the Parent Project Structure #

• Make a new directory for your parent project (e.g., my-multi-module)
• Inside this directory, create a pom.xml with pom packaging:

<?xml version="1.0" encoding="UTF-8"?>
<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.yourcompany</groupId>
    <artifactId>my-multi-module</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <modules>
        <!-- Submodule will be added here -->
    </modules>
</project>

2. Integrate char-counter as a Submodule #

• Move your existing char-counter folder into the parent project directory
• Update the parent's pom.xml to add <module>char-counter</module> inside the <modules> section
• Edit char-counter's pom.xml to include the <parent> section as shown in the Eclipse guide above

3. Validate the Configuration #

• Open a terminal, navigate to the parent project directory
• Run mvn clean install—this should build the parent and char-counter without errors
• If you later import the parent project into an IDE, it will automatically recognize char-counter as a submodule

内容的提问来源于stack exchange，提问作者IceTeaGreen