IntelliJ IDEA
 
2023.2
快捷方式：Windows
获取 IntelliJ IDEA
  1. 项目配置
  2. 模块

模块

最后修改时间：2023 年 9 月 7 日

在 IntelliJ IDEA 中，模块是任何项目的重要组成部分 - 它与项目一起自动创建。项目可以包含多个模块 - 您可以添加新模块、对它们进行分组，以及卸载目前不需要的模块。

通常，模块由一个或多个内容根和一个模块文件组成，但是，模块可以在没有内容根的情况下存在。内容根目录是存储代码的文件夹。通常，它包含源代码、单元测试、资源文件等的子文件夹。模块文件（.iml文件）用于保存模块配置。

模块允许您在一个应用程序中组合多种技术和框架。在 IntelliJ IDEA 中，您可以为一个项目创建多个模块，每个模块都可以负责自己的框架。有关更多信息，请参阅添加框架（方面）。

方案中显示的模块组成

提示

有关在项目中使用模块的更多信息，请参阅配置项目。

IntelliJ IDEA 模块与 Java 模块

在版本 9 中，Java 引入了Java 平台模块系统。IntelliJ IDEA 已经有了模块的概念：每个 IntelliJ IDEA 模块都构建了自己的类路径。随着新的 Java 平台模块系统的引入，出现了两个模块化系统：IntelliJ IDEA 模块和使用module-info.java配置的新 Java 9 模块。本文档部分介绍 IntelliJ IDEA 模块。

有关 Java 9 支持的更多信息，请参阅IntelliJ IDEA 2017.1 中对 Java 9 模块的支持以及Java 9 和 IntelliJ IDEA博客文章。

具有多个模块的项目

IntelliJ IDEA 允许您在一个项目中拥有多个模块，并且它们不必全部都是 Java。您可以为 Java 应用程序使用一个模块，为 Ruby on Rails 应用程序或任何其他支持的技术使用另一个模块。

由客户端和服务器端组成的应用程序是双模块项目的一个很好的例子。

将新模块添加到您的项目中

  1. 在“项目”工具窗口中选择顶级目录，然后按或选择“新建”|“ 上下文菜单中的模块。AltInsert

    新建模块向导打开。

  2. 从左侧列表中选择模块类型。为新模块命名。

  3. 从语言列表中，选择您要在应用程序中使用的语言。

    如果您想使用 IntelliJ IDEA 中未提供的开箱即用语言（例如 Python 或 PHP），请单击 按钮应用程序常规添加并选择必要的选项。

    IDE 将打开一个对话框，您可以在其中选择并安装必要的语言插件。之后，您可以关闭对话框并继续配置新模块。

  4. 选择要在项目中使用的构建系统：本机 IntelliJ 构建器、Maven或Gradle。

    对于 Gradle，您还需要选择构建脚本的语言：Groovy 或 Kotlin。

  5. 从JDK列表中选择您要使用的JDK。您可以使用项目 SDK 或指定一个新的 SDK。

  6. 单击创建。

导入现有模块

您可以通过添加另一个项目中的.iml文件来将模块导入到您的项目中：

  1. 转到文件| 新 | 来自现有来源的模块。

  2. 在打开的对话框中，指定要导入的模块的.iml文件的路径，然后单击“打开”。

    通过这样做，您可以将另一个模块附加到项目中，而无需物理移动任何文件。如果您不需要将模块放在一个文件夹中，则模块导入已完成，您可以开始正常使用该项目。

    提示

    如果您希望模块位于同一文件夹中，请在“项目”工具窗口中将导入的模块拖至顶级目录。在这种情况下，导入模块的内容将物理传输到项目的文件夹中。

笔记

有关将 Maven 或 Gradle 项目附加到当前项目的更多信息，请参阅将Gradle 项目链接到 IntelliJ IDEA 项目和链接和取消链接 Maven 项目。

如果项目来自外部模型，或者您想要从现有源代码创建不一定是导出项目的模块，请使用这些步骤将项目导入为模块。

  1. 转到文件| 新 | 来自现有来源的模块。

  2. 选择源、库和其他资产所在的目录，然后单击“打开”。

  3. 如果要从现有源代码创建新模块，请在打开的对话框中选择从现有源创建模块。

    否则，选择从外部模型导入项目，选择项目使用的外部模型，然后按照向导的步骤进行操作。

组模块

在 IntelliJ IDEA 中，您可以对模块进行逻辑分组。如果您有一个包含多个模块的大型项目，分组将使您更轻松地浏览项目。模块组可以嵌套：一个组可以包含其他子组。

在早期版本（2017.2 及更早版本）中，IntelliJ IDEA 使用显式组将模块连接在一起。如果您已配置手动模块组，则您将能够在更高版本的 IDE 中继续使用它们。或者，您可以转换模块组并使用限定名称。

  1. 在项目工具窗口 ( ) 中，选择要分组的模块。Alt01

    您还可以在“项目结构”对话框 ( )的“模块”页面上执行此操作。CtrlAltShift0S

  2. 从上下文菜单中，选择将模块移至组| 新的顶级集团。

  3. 为新组命名并单击“确定”。

    新组现已创建并标有 图标模块组。

选择“外部任何组”以从组中排除选定的模块，选择“到此组”以将模块添加到组中，或选择“到新子组”以在另一个组中创建新组。

  1. 转到文件| 将模块组转换为限定名称。

  2. 在下一个对话框中，检查新模块名称并根据需要进行调整。

  3. 单击“应用”保存更改并关闭对话框。

按完全限定名称对模块进行分组

IntelliJ IDEA 2017.3 及更高版本使用完全限定名称对模块进行分组。例如，如果要对所有 CDI 模块进行分组，请cdi在其名称中添加前缀。

  1. 打开“项目结构”对话框并单击“模块”。CtrlAltShift0S

  2. 选择要分组的模块，打开上下文菜单，然后单击更改模块名称。

  3. 指定前缀并应用更改。

    要在“项目结构”对话框中查看同一级别的所有模块，请使用“展平模块”上下文菜单选项。

    提示

    如果启用了“展平模块”选项，则模块组在“项目”工具窗口 ( )中将不可见。您可以通过工具窗口标题中的按钮禁用它。Alt01显示选项菜单

    /help/img/idea/2023.2/change-module-names.png
    动图