IntelliJ IDEA 2025.1 Help

构建工具导入过程

作为开发人员,您经常使用构建工具来管理和组织您的构建。 项目越大,构建工具对您的工作就越重要。

IntelliJ IDEA 具有自己本地的构建系统,或者您可以使用外部构建工具,例如 MavenGradleAntGantsbt (用于 Scala 插件)来构建和部署您的项目。

对大多数 IntelliJ IDEA 支持的构建工具的集成都已默认捆绑并启用。 最最受欢迎的且广泛使用的构建工具是 MavenGradle ,IntelliJ IDEA 提供完全集成。

项目导入

一个常见的使用构建工具项目的情景是,您已经在某个地方存有一个现有项目,并希望在 IDE 内处理该项目。

首先,您需要确保信任打开项目的来源。 如果您不信任该来源,IntelliJ IDEA 会在预览模式下打开该项目,该模式包含有关您的项目的有限信息。 有关项目安全的更多信息,请参阅 项目安全性

如果您在 IDE 内从可信来源打开该项目,IntelliJ IDEA会“导入”它。 这意味着 IntelliJ IDEA 不仅会打开您的项目,还会执行将该项目集成到 IDE 中的操作。

让我们看看在导入过程中实际发生了什么:

  • IntelliJ IDEA 在单独的 Java 进程中执行构建脚本中的代码,该进程是使用所选的 MavenGradle JVM 创建的

  • 基于构建工具配置文件,IntelliJ IDEA 配置项目结构。 例如,它会设置 source/resource/test source/test 资源目录,并且为每个模块设置 Java 编译器源级别和目标级别

  • IntelliJ IDEA 根据构建配置文件中配置的依赖项,将库添加到 模块依赖中,解析项目模块之间的依赖关系,并在整个项目中同步依赖关系;

  • IntelliJ IDEA 为项目设置语言级别;

  • 对于 Gradle 项目,IntelliJ IDEA 还会为每个 Gradle source set 创建 IDE 模块

  • 对于 Java Web 模块,IntelliJ IDEA 启用 Web 应用程序支持并创建 Web 应用程序工件

什么触发项目导入

IntelliJ IDEA 在导入过程中执行许多操作,而且不仅限于您打开项目时。

请检查触发导入过程的以下情况:

  • 打开 从 VCS 导入项目——当您从 Git、Mercurial 等版本控制系统之一克隆项目时,导入过程就会开始。

  • Open 一个来自外部模型的项目——当您不确定项目中使用了哪种构建工具或使用了多个工具时,您可以选择要从哪个模型导入项目。

    导入项目
  • 打开 一个本地目录中的项目——这是项目驻留在您的机器上的简单情况。

  • 打开 一个来自 WSL 文件系统的项目——在这种情况下,您的项目存储在 WSL 中,但 IntelliJ IDEA 让您可以像从本地文件系统一样打开它。

  • 向已打开的项目添加项目——这种情况是当您使用某个构建工具的工具窗口向 IDE 中已打开的项目添加项目时,或者在 Gradle 的情况下, 链接一个项目。

    添加 Maven 项目
    关联 Gradle 项目
  • 构建脚本更改时加载更改——在这种情况下,您在编辑器中点击加载更改图标或在 GradleMaven 等构建工具窗口中的项目上选择重新加载操作时,会触发导入过程。

  • 重新加载所有项目——在这种情况下,当您点击构建工具工具窗口中的重新加载图标时,您会触发导入过程。

    重新加载所有 Maven 项目
    重新加载所有 Gradle 项目

有关使用构建工具的更多信息,请参阅以下部分:

最后修改日期: 2025年 4月 24日