# Gradle

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

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

使用此页面配置 [Gradle 项目](gradle-support.html)的设置。

|  项  |  描述  |
| --- | --- |
|    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` 或  `PATH` 中定义，CLion将推断出此位置并将其路径建议为默认值。       CLion 还支持从 [Homebrew](https://docs.gradle.org/current/userguide/installation.html#installing_with_a_package_manager) 软件包管理器安装的自定义 Gradle 位置。     |
|    启用 Gradle 7.4+ 的并行 Gradle 模型获取    |     选择此选项以加快项目的导入。       此选项在新创建的项目中将自动禁用。 它在  `文件 \| 新建项目设置 \| 新建项目设置`  中也已禁用。       如果从 VCS 检出一个包含  `.idea`  文件夹且已禁用 parallel import 功能的项目，该项目将在   启用 Gradle 7.4+ 的并行 Gradle 模型获取   被禁用的情况下打开。     |
|    Gradle 项目    |  此区域包含与您的 CLion 项目关联的已注册 [Gradle 项目](gradle-support.html)列表。  |
|    为依赖项下载外部注解    |  选择此复选框后，CLion 会从 [JetBrains public repository](https://packages.jetbrains.team/maven/p/ij/intellij-redist/org/jetbrains/externalAnnotations/)下载包含一组外部注释的文件。  |
|    Gradle    |  |
|  分发  |  使用此列表为您的项目配置 Gradle 版本。    您可以选择以下选项之一：        * Gradle 构建脚本中的 'wrapper' 任务 ：选择此选项可根据 `wrapper` 任务配置来配置 Gradle 包装器。 如果您希望控制项目中使用的 Gradle 版本，此选项可能更为方便。 如果您使用了默认的 Gradle 包装器选项，然后切换到 Gradle `wrapper` 任务配置，则您在该任务中所做的更改会在项目导入期间自动更新。    * 指定位置 ：如果您不想使用 Gradle wrapper，而是希望手动下载并使用特定的 Gradle 版本，请选择此选项。 指定您的 Gradle 安装位置。    |
|    Gradle JVM    |     此字段用于指定 JVM，在导入指定的 Gradle 项目和执行其任务时，CLion 将在该 JVM 下运行 Gradle。 默认设置为您的项目 JDK。     |

