IDEA将普通目录（文件夹）重新设置为 Module（模块）

前言

在使用 IntelliJ IDEA 进行日常开发时，你可能遇到过以下两种令人头疼的场景：

  1. 手滑删除了模块（Remove Module）： 当你在 Project 视图中选中一个 Module，右键选择了 Remove Module（或者按了 Delete 键）之后，你会发现该文件夹右下角的蓝色小方块图标消失了。此时文件和代码都还在，但 IDEA 已经不再把它当成一个完整的模块来对待了，代码提示和依赖管理全部失效。
  2. 从 Git 刚克隆下来的多模块项目： 当你开开心心地从 Git 上 clone 了一个包含多个子模块的项目并用 IDEA 打开时，IDEA 有时候会“装傻”，无法自动识别出里面的子模块。此时所有的子工程看起来都只是普通的文件夹。

image-20260506143436725

下面展示如何修复。

具体操作步骤

1. 打开Module设置（Open Module Setting）

image-20260506143635603

第二步：在Module设置中选择Import Module

找到并点击 Modules 选项。这里列出了当前项目下所有被 IDEA 识别的模块，点击加号，选择Import Module

  1. 点击窗口中间上方部分的 + 号（Add 按钮）。
  2. 在下拉菜单中选择 Import Module。

image-20260506143840010

第三步：导入模块 (Import Module)

点击 OK 后，IDEA 会问你以什么方式导入这个模块，通常有两个选项：

  • 选项 A：Create module from existing sources (从现有源码创建)

    如果你的项目是一个普通的 Java SE 项目，没有使用任何构建工具，选择这个，然后一路点击 Next 即可。

  • 选项 B：Import module from external model (从外部模型导入) 【强烈推荐】

    如果你的项目使用的是 Maven 或 Gradle 构建的（绝大多数企业级项目都是），按需求选择

    选中对应的构建工具（例如 Maven），然后点击 Finish。

image-20260506143936707

3. 应用并生效

回到 Project Structure 窗口，点击右下角的 Apply，然后点击 OK。

总结

IDEA 的 Remove Module 仅仅是解除了逻辑上的模块绑定，并不是物理删除文件，只要重新引入。