如何重命名java Module模块

在 Java 项目中（尤其是使用 IntelliJ IDEA 或 Maven/Gradle 构建工具时），“重命名 Module（模块）”通常包含 IDE 层重命名 和 构建配置层重命名 两部分。下面按常见情况说明。

一、IntelliJ IDEA 中重命名 Java Module（最常见）

方式一：通过 Project 视图重命名（推荐）

1. 打开 Project 视图
2. 右键点击要重命名的 Module
3. 选择 Refactor → Rename
4. 勾选：
   • Rename module
   • Rename directory（如需要）
5. 点击 Refactor

IDEA 会自动修改 .iml 文件和项目配置。

方式二：通过 Project Structure 重命名

1. File → Project Structure
2. 选择 Modules
3. 选中模块，点击上方名称进行编辑
4. Apply → OK

二、Maven 多模块项目中重命名 Module

如果是 Maven 项目，仅靠 IDE 重命名不够，还需要改 pom.xml。

步骤

1. 修改子模块目录名

   mv old-module new-module
   

2. 修改子模块 pom.xml

   <artifactId>new-module</artifactId>
   

3. 修改父模块 pom.xml

   <modules>
       <module>new-module</module>
   </modules>
   

4. 在 IDEA 中：

   • 重新导入 Maven 项目
   • 删除旧的 .iml 文件（如有）

三、Gradle 多模块项目中重命名 Module

步骤

1. 修改模块目录名
2. 修改 settings.gradle

   include 'new-module'
   

3. 如使用了 rootProject.name 或 archivesBaseName，同步修改
4. 在 IDEA 中刷新 Gradle

四、常见注意事项

• 包名不一定需要改（module ≠ package）
• 重命名后若编译报错，执行：
  • Maven：mvn clean install
  • Gradle：gradle clean build
• Git 用户建议先提交，再重命名，避免混乱

五、示例（Maven）

原结构：

parent
 ├─ old-module
 │   └─ pom.xml
 └─ pom.xml

重命名后：

parent
 ├─ new-module
 │   └─ pom.xml
 └─ pom.xml

如果你指的是 JPMS（Java Platform Module System，module-info.java） 或某种特定构建工具，可以告诉我，我可以给你更精确的方案。