Gradle 设置

Gradle 用户主目录

请使用此字段指定 Gradle 存储其全局配置属性、初始化脚本、缓存、日志文件等的位置。 如需更多信息，请参阅 Gradle 文档。

默认设置为 $USER_HOME/.gradle 。 这可以通过以下几种方式之一进行覆盖：

• 您可以设置 GRADLE_USER_HOME 环境变量（例如， %APPDATA%\.gradle）。 如需更多信息，请参阅 Gradle 文档。 变量的值会被自动获取。 新路径已反映在该字段中。

• 您可以手动指定位置：在路径中输入位置或点击 ，在打开的对话框中选择所需的目录。

如果 Gradle 的位置在 指定位置 选项中的 使用来自此位置的 Gradle 设置，并且其路径在环境变量 GRADLE_HOME 或 PATH 中定义，IntelliJ IDEA将推断出此位置并将其路径建议为默认值。

IntelliJ IDEA 还支持从 Homebrew 软件包管理器安装的自定义 Gradle 位置。

为从 Gradle 导入的模块生成 *.iml 文件

选择此选项以将生成的 .iml 和库文件存储在 .idea 目录中，而不是 idea.system.path 。

在以下情况下可能有所帮助：

• 通过 VCS 共享特定于 IDE 的模块设置，因为 .idea 目录存储 项目级别设置。 您也可以选择 gradle-idea-ext 插件，它可以帮助您在 build.gradle 文件中描述 项目设置。

• 正确打开包含常规 IntelliJ IDEA 模块和 Gradle 模块的项目。

• 在打开项目时更快地访问项目，因为 IntelliJ IDEA 会先读取 .iml 文件，然后再开始导入过程。

为 Gradle 7.4 启用并行 Gradle 模型提取+

选择此选项以加快项目的导入。

此选项在新创建的项目中将自动禁用。 它在 文件 | 新建项目设置 | 新建项目设置 中也已禁用。

如果从 VCS 检出一个包含 .idea 文件夹且已禁用 parallel import 功能的项目，该项目将在 为 Gradle 7.4 启用并行 Gradle 模型提取+ 被禁用的情况下打开。

Gradle 项目

在 IntelliJ IDEA 中工作时，您可以拥有多个 链接的 Gradle 项目。 您可以为每个选定的项目配置设置。

下载依赖项的外部注解

选择此复选框后，IntelliJ IDEA 会从 JetBrains public repository下载包含一组外部注释的文件。

构建并运行

请使用此部分来指定在运行测试、构建或运行所选链接项目中的任务时 IntelliJ IDEA 应使用的内容。

使用此工具构建和运行

使用此列表选择如何 构建和运行您的项目。 请使用 Gradle 作为默认选项或选择 IntelliJ IDEA。

在这种情况下，当您从主菜单中选择 构建 | 构建项目 时，IntelliJ IDEA 会遍历所有模块中的源集，执行 Gradle 任务 classes。

如果您有一个纯 Java 或 Kotlin 项目，有时候选择 IntelliJ IDEA 来构建项目会更好。 IntelliJ IDEA 支持 增量构建 ，显著加快构建过程。 请注意，IntelliJ IDEA 编译器不支持 Gradle 项目构建处理的某些部分，可能会导致构建项目时出现问题。

使用此工具运行测试

使用此列表选择您希望如何在项目中 运行测试。 请使用 Gradle 作为默认选项或选择 IntelliJ IDEA。

Gradle

分发

使用此列表为您的项目配置 Gradle 版本。

您可以选择以下选项之一：

• 'gradle-wrapper.properties' 文件 ：这是推荐的默认选项，它使用了 Gradle wrapper。

  在这种情况下，您将 Gradle 版本的更新委托给 Gradle，并为构建自动下载 Gradle。 此选项还允许您使用精确的 Gradle 版本进行构建。 Gradle 版本保存在项目的 gradle-wrapper.properties 文件的 gradle 目录中，有助于消除任何 Gradle 版本问题。

• Gradle build 脚本中的 'wrapper' 任务 ：选择此选项以根据 wrapper 任务配置设置 Gradle wrapper。 如果您希望控制项目中使用的 Gradle 版本，这可能会很方便。

  如果您使用了默认的 Gradle wrapper 选项，然后切换到 Gradle wrapper 任务配置，那么您对该任务所做的更改将在项目导入期间自动更新。

• 指定位置 ：如果您不想使用 Gradle wrapper，而是希望手动下载并使用特定的 Gradle 版本，请选择此选项。 指定您的 Gradle 安装位置。

Gradle JVM

此字段用于指定 JVM，在导入指定的 Gradle 项目和执行其任务时，IntelliJ IDEA 将在该 JVM 下运行 Gradle。 默认设置为您的项目 JDK。

此字段将覆盖其他任何 Gradle JVM 选择。 您可以在 Gradle JVM 选择 部分查看 IntelliJ IDEA 如何选择 Gradle JVM 版本的过程。