# Gradle 设置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件：   Gradle  （ [已安装](managing-plugins.html) 并默认启用）
>
>
>
> 访问：  `设置 | 构建、执行、部署 | 构建工具 | Gradle`

`设置 | 构建、执行、部署 | Gradle`

请使用本页面配置为 [创建](gradle.html#project_create_gradle)、 [打开](gradle.html#gradle_import_project_start)或 [链接](gradle.html#link_gradle_project)的 Gradle 项目设置。

> **Note:**
> 要配置离线模式，请参考 [Gradle tool window](jetgradle-tool-window.html#offline)。 如果您需要添加 VM 选项，请参阅 [Gradle VM options](gradle.html#gradle_vm_options)。

|  条目  |  描述  |
| --- | --- |
|    Gradle 用户主目录    |     请使用此字段指定 Gradle 存储其全局配置属性、初始化脚本、缓存、日志文件等的位置。 如需更多信息，请参阅 [Gradle 文档](https://docs.gradle.org/current/userguide/directory_layout.html#dir:gradle_user_home)。       默认设置为  `$USER_HOME/.gradle` 。 这可以通过以下几种方式之一进行覆盖：        * 您可以设置 `GRADLE_USER_HOME` 环境变量（例如， `%APPDATA%\.gradle` ）。 如需更多信息，请参阅 [Gradle 文档](https://docs.gradle.org/current/userguide/build_environment.html#sec:gradle_environment_variables)。 变量的值会被自动获取。 新路径已反映在该字段中。 > **Note:** > 您可能需要重新启动您的 IDE 以使更改生效。    * 您可以手动指定位置：在路径中输入位置或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)，在打开的对话框中选择所需的目录。 > **Note:** > 手动输入的值优先于环境变量。      如果 Gradle 的位置在   指定位置  选项中的   使用以下来源的 Gradle  设置，并且其路径在环境变量  `GRADLE_HOME` 或  `路径` 中定义，IntelliJ IDEA将推断出此位置并将其路径建议为默认值。       IntelliJ IDEA 还支持从 [Homebrew](https://docs.gradle.org/current/userguide/installation.html#installing_with_a_package_manager) 软件包管理器安装的自定义 Gradle 位置。     |
|    为从 Gradle 导入的模块生成 *.iml 文件    |  选择此选项以将生成的  `.iml` 和库文件存储在  `.idea` 目录中，而不是  `idea.system.path` 。    在以下情况下可能有所帮助：        * 通过 VCS 共享特定于 IDE 的模块设置，因为 `.idea` 目录存储 [项目级别设置](configure-project-settings.html)。 您也可以选择 [gradle-idea-ext](https://github.com/JetBrains/gradle-idea-ext-plugin) 插件，它可以帮助您在 `build.gradle` 文件中描述 [项目设置](work-with-gradle-projects.html#project_encodings)。    * 正确打开包含常规 IntelliJ IDEA 模块和 Gradle 模块的项目。    * 在打开项目时更快地访问项目，因为 IntelliJ IDEA 会先读取 `.iml` 文件，然后再开始导入过程。     > **Note:** > 当您在 Gradle 项目中进行更改时，  `.iml`  文件也会发生变化，所以不要忘记将它们与其他项目的变更一同提交到 VCS 下。    |
|    为 Gradle 7.4+ 启用并行获取 Gradle 模型    |     选择此选项以加快项目的导入。       此选项在新创建的项目中将自动禁用。 它在  `文件 \| 新建项目设置 \| 新建项目设置`  中也已禁用。       如果从 VCS 检出一个包含  `.idea`  文件夹且已禁用 parallel import 功能的项目，该项目将在   为 Gradle 7.4+ 启用并行获取 Gradle 模型   被禁用的情况下打开。     |
|    Gradle 项目    |  在 IntelliJ IDEA 中工作时，您可以拥有多个 [链接的 Gradle 项目](gradle.html#link_gradle_project)。 您可以为每个选定的项目配置设置。  |
|    为依赖项下载外部注解    |  选择此复选框后，IntelliJ IDEA 会从 [JetBrains public repository](https://packages.jetbrains.team/maven/p/ij/intellij-redist/org/jetbrains/externalAnnotations/)下载包含一组外部注释的文件。  |
|    构建并运行    |  请使用此部分来指定在运行测试、构建或运行所选链接项目中的任务时 IntelliJ IDEA 应使用的内容。  |
|    构建和运行使用    |  使用此列表选择如何 [构建和运行您的项目](work-with-gradle-projects.html#delegate_build_gradle)。 请使用   Gradle   作为默认选项或选择   %instance%  。    在这种情况下，当您从主菜单中选择   构建 \| 构建项目   时，IntelliJ IDEA 会遍历所有模块中的源集，执行 Gradle 任务  `类` 。      ![构建输出](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_build.png)    如果您有一个纯 Java 或 Kotlin 项目，有时候选择 IntelliJ IDEA 来构建项目会更好。 IntelliJ IDEA 支持 [增量构建](compiling-applications.html#compile_module)，显著加快构建过程。 但请注意，IntelliJ IDEA 编译器不支持 Gradle 项目构建处理的某些部分，可能会导致项目无法正确构建。     |
|    使用此工具运行测试    |  使用此列表选择您希望如何在项目中 [运行测试](work-with-tests-in-gradle.html)。 请使用   Gradle   作为默认选项或选择   %instance%  。  |
|    Gradle    |  |
|  分发  |  使用此列表为您的项目配置 Gradle 版本。    您可以选择以下选项之一：        * 'gradle-wrapper.properties' 文件 ：这是推荐的默认选项，使用 [Gradle 包装器](https://docs.gradle.org/current/userguide/gradle_wrapper.html)。 在这种情况下，将 Gradle 版本的更新委托给 Gradle，并在构建时自动下载 Gradle。 此选项还允许您使用精确的 Gradle 版本进行构建。 Gradle 版本保存在项目的 `gradle-wrapper.properties` 文件的 `gradle` 目录中，有助于消除任何 Gradle 版本问题。    * Gradle 构建脚本中的 'wrapper' 任务 ：选择此选项可根据 `wrapper` 任务配置来配置 Gradle 包装器。 如果想控制项目中使用的 Gradle 版本，这可能会很方便。 如果使用了默认的 Gradle 包装器选项，然后切换到 Gradle `wrapper` 任务配置，则在该任务中所做的更改会在项目导入期间自动更新。    * 指定位置 ：如果您不想使用 Gradle wrapper，而是希望手动下载并使用特定的 Gradle 版本，请选择此选项。 指定您的 Gradle 安装位置。    |
|    Gradle JVM    |     此字段用于指定 JVM，在导入指定的 Gradle 项目和执行其任务时，IntelliJ IDEA 将在该 JVM 下运行 Gradle。 默认设置为您的项目 JDK。       此字段将覆盖其他任何 Gradle JVM 选择。 您可以在 [Gradle JVM 选择](gradle-jvm-selection.html) 部分查看 IntelliJ IDEA 如何选择 Gradle JVM 版本的过程。     |
|    Gradle JVM 标准    |  启用 [Gradle 守护进程工具链支持](https://docs.gradle.org/current/userguide/gradle_daemon.html#configuring_the_daemon_jvm) 后，此部分可用。    有关如何启用该支持的信息，请参阅 [配置 Gradle 守护进程工具链](gradle.html#gradle_daemon_toolchain)。       可以为项目选择 JDK 版本和供应商。     |

## See also

### 语言和框架特定指南

[Gradle](gradle.html)