# Gradle

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

> **TL;DR**
> 必需插件  ： [Gradle](https://plugins.jetbrains.com/plugin/13112-gradle)

[Gradle](https://gradle.org/) 是一个构建自动化系统，提供用于构建 C/C++ 库和应用程序的插件。 在 CLion 中，您可以使用基于  cpp-application  和  cpp-library  插件的 Gradle 项目（有关 C/C++ Gradle 插件的更多详细信息，请参阅此博客文章： [Introducing the new C++ plugins](https://blog.gradle.org/introducing-the-new-cpp-plugins)）。

CLion 中的 Gradle 支持正在开发中。 您可以通过此工单分享您的反馈并关注更新： [CPP-1104](https://youtrack.jetbrains.com/issue/CPP-1104)

> **Note:**
> 在开始之前，请确保 [安装](managing-plugins.html#install_plugin_from_repo)并启用 [Gradle](https://plugins.jetbrains.com/plugin/13112-gradle) 插件

Procedure: 打开 Gradle 项目

1. 从主菜单中选择  `文件 | 打开` ，并将 CLion 指向   构建.gradle   文件。

2. 在打开的对话框中，点击   作为项目打开  。

3. CLion 将加载项目，并在   构建   工具窗口中显示进度和状态：

![已打开的 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_projectopen.png)

Procedure: 调整项目设置

1. 转到  `设置 | 构建、执行、部署 | 构建工具 | Gradle` 。

2. 如有需要，请配置项目设置：

![Gradle 项目设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_settings.png)

有关更多信息，请参阅对话框的 [参考页面](gradle-settings.html)。

## 配置自动重新加载

默认情况下，CLion 不会自动重新加载您的项目，除非发生外部更改（如 VCS 更新）。 您可以在   构建工具   设置中更改此行为。

Procedure:

1. 转到  `设置 | 构建、执行、部署 | 构建工具` 。

2. 选择一个自动重新加载选项：

![自动重新加载设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_autoreload_settings.png)

* 任何更改 - 项目重新加载将在 `构建.gradle` 脚本中的任何更改时触发。

* 外部更改 （默认）- 您的项目仅在外部事件（如 VCS 更新）时重新加载。 如果发生其他更改，需要手动重新加载项目。 使用以下选项之一： * 点击编辑器中出现的弹出窗口： ![用于重新加载项目的编辑器弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_reload_popup.png) * 点击 ![重新加载 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.refresh.svg) 在 构建 工具窗口中： ![从构建工具窗口重新加载项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_reimport_syncwindow.png) * 点击 ![重新加载所有 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.refresh.svg) 在 Gradle 工具窗口中： ![从 Gradle 工具窗口重新加载项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_reload_gradlewindow.png)

> **Tip:**
> 此设置适用于每个项目。 自动重新加载选项应分别为您的 Gradle、 [compilation database](compilation-database.html) 或 [Makefile](makefiles-support.html) 项目进行配置。

## Gradle 项目的运行/调试配置

CLion 从   构建.gradle   文件中提取运行/调试配置。 可以在  `运行 | 编辑运行/调试配置`  对话框中更改提取的配置并创建新配置。

Gradle 项目有两种运行/调试配置可用， ![](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradle.svg)Gradle 和 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.application.svg)Gradle Native Application（后者需要 [Gradle Native](https://plugins.jetbrains.com/plugin/17996-gradle-native) 插件）。

Procedure: 设置 Gradle 配置

![Gradle 配置设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_config_prj.png)

在 ![](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradle.svg) Gradle 配置对话框中，配置以下设置：

* 运行 - 指定您想要执行的任务。 请注意，您可以在一个运行/调试配置中运行多个任务。 例如， `clean` 和 `构建` 。 您还可以在此处添加 [Gradle 命令行参数](https://docs.gradle.org/current/userguide/gradle_command_line.html)，例如， `--debug` 。

* Gradle 项目 - 指定您的 Gradle 项目的位置。 点击 ![cl_gradle_prjicon.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_prjicon.png) 从已注册的 Gradle 项目列表中选择。

> **Tip:**
> 请参阅 [运行/调试配置：Gradle](run-debug-gradle.html) 了解更多信息。

Procedure: 设置 Gradle Native Application 配置

> **Note:**
> 要使用此配置，您需要额外安装 [Gradle Native](https://plugins.jetbrains.com/plugin/17996-gradle-native) 插件。

在 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.application.svg) Gradle Native Application 配置对话框中：

* 在 目标 字段中，从列表中选择所需的目标： ![Gradle Native Application 的目标列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_nativetarget.png)

* 在 可执行文件 字段中，为您的配置选择合适的可执行文件。

## 使用 Gradle 任务

CLion 允许您通过多种方式运行 Gradle 任务，例如使用 [Gradle 工具窗口](jetgradle-tool-window.html) 中的工具栏、运行配置或上下文菜单。

Procedure: 从 Gradle 工具栏运行 Gradle 任务

1. 在   Gradle   工具窗口（  `视图 | 工具窗口 | Gradle` ）中，点击工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradle.svg)。

2. 在打开的   运行 Gradle 任务   对话框中，开始在   命令行   字段中输入任务名称。 CLion 显示 Gradle 任务列表，您可以从中选择适当的任务：

![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_runtask.png)

3. CLion 运行所选任务，并在   运行   工具窗口中显示结果：

![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_runtask2.png)

CLion 还会将任务保存在   运行配置   节点下，位于   Gradle   窗口中：

![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_runtask3.png)

Procedure: 使用上下文菜单运行 Gradle 任务

* 第一个选项是从   Gradle 项目   工具窗口中所需任务的上下文菜单中选择   运行  。

* 如果任务已经有相应的运行/调试配置，您将在上下文菜单中看到   Select   选项。 您可以使用此选项设置活动配置，然后运行它。

![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_runtask4.png)

* 如果任务没有相应的配置，上下文菜单将包含   创建   选项。 选择此选项以打开运行/调试配置对话框，并使用所选任务创建配置。

* 所有可用的运行/调试配置都列在   运行配置   节点下。 使用上下文菜单中的   运行   选项运行此节点下显示的任务：

![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_runtask6.png)

## 运行 Gradle Native 应用程序

> **Note:**
> 要运行 Gradle Native 应用程序，需要额外安装 [Gradle Native](https://plugins.jetbrains.com/plugin/17996-gradle-native) 插件。

在 CLion 中，可以像运行常规应用程序一样 [运行](running-applications.html)和 [调试](debugging-code.html) Gradle Native 应用程序。

例如，可以使用代码入口点旁边左侧装订区域中的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) 图标。 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) 并从列表中选择所需的操作。 如果目标没有现有的 Gradle Native 配置，则在启动之前会创建一个新配置。

![运行标记区](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gradle_rungutter.png)

> **Tip:**
> 使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 按钮快速访问   Gradle   设置页面。

## 问题和限制

在 CLion 中 Gradle 支持的当前初始阶段，存在一些已知问题和功能限制：

* CLion 不提供 Gradle 的项目模板，因此您无法通过新建项目向导创建新的 Gradle 项目。

* 无法调试 Gradle 任务本身。

