# 运行/调试配置：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)
>
>
>
> 创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| Gradle`

> **Tip:**
> 有关更多信息，请参阅 [设置 Gradle 配置](gradle-support.html#gradle-config)。

您可以使用运行配置 [运行 Gradle 任务](null)。 在此配置中列出的默认选项足以运行您的任务。 如果您愿意，您还可以通过使用其他选项或添加更多任务和参数来创建高级配置。

Procedure: 创建运行/调试 Gradle 配置

1. 从主菜单中选择   添加配置  。 或者，右键点击   Gradle   工具窗口中的任何任务，然后选择   修改运行配置  。

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

2. 在   名称   字段中指定您的配置名称，以便在编辑或运行配置时能够快速识别，例如，从   运行   弹出窗口 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `⌘ ⌃ ⌥ ⇧ R` (Xcode), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+R` (ReSharper), `⌘ ⌥ ⇧ R` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `⌘ T` (QtCreator (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) 或   Gradle   工具窗口。

3. 如果您需要，请指定   存储为项目文件  来保存运行配置设置文件，这样您就可以与其他团队成员共享它。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目中的任何其他目录。

若要更改位置，请选择此选项并点击 ![管理文件位置图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)，在打开的对话框中添加新位置。

4. 如果您不需要在   运行  字段指定任何内容，默认任务如  `help` 以及在 [构建前](null)部分指定的任务。 该部分将被执行。 或者，如果您是在   Gradle   工具窗口中创建运行配置，则您选择的任务将显示在此字段中。 但是，您可以为运行配置指定其他外部任务和 [arguments](https://docs.gradle.org/current/userguide/gradle_command_line.html)。 请使用空格将一个任务与另一个任务分开。 如果您想查看可用的 Gradle 任务和参数列表，请点击字段中的 ![插入任务和参数图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineVariables.svg)。

5. 指定您的 Gradle 项目的位置。

您可以手动输入或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)并在打开的对话框中指向所需位置。 然而，如果您从   Gradle  工具窗口创建运行配置，CLion会自动显示您的项目名称。

您还可以点击   Gradle 注册项目   ![模块节点](https://resources.jetbrains.com/help/img/idea/2026.3/app.nodes.Module.svg)图标，从您现有 CLion 项目中已注册的 Gradle 模块列表中选择一个可用的 Gradle 模块。

如果需要，您可以指定构建脚本文件的路径而不是项目路径。 这可能对您参考自定义构建脚本有所帮助。

6. 如果需要，请指定您要在项目中使用的环境变量。

7. 以下默认选项已启用，但您可以点击   修改选项  并使用 [Add Run Options](#add_advanced)列表添加新选项或删除某些默认选项：

* 启动时打开运行/调试工具窗口 ——在执行配置时自动打开运行/调试工具窗口以及几个调试器选项

* 调试 Gradle 脚本 - 启用 Gradle 脚本中的断点。

## 添加运行选项

> **Tip:**
> 点击   修改选项  在   运行/调试配置  对话框中打开运行选项列表。

添加运行选项   列表允许您向   运行/调试配置   对话框添加更多运行选项或从中删除一些默认选项。 列表分为几个部分，因此您可以轻松浏览可用选项。

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

### 操作系统

|  项  |  描述  |
| --- | --- |
|    允许多个实例    |  选择此选项以允许并行运行此运行配置的多个实例。 默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。  |

### Java

|  项  |  描述  |
| --- | --- |
|    VM 选项    |     指定在启动应用程序时传递给 Java 虚拟机的选项，例如，  `-mx` 、  `-verbose` 等。       在指定 JVM 选项时，请遵循以下规则：        * 使用空格分隔各个选项。    * 如果选项的值包含空格，请用双引号将值或实际空格括起来。    * 如果一个选项包含作为值一部分的双引号，请使用反斜杠对双引号进行转义。    * 您可以将环境变量值传递给自定义 Java 属性。      ```PLAINTEXT -Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}  ```      在此字段中使用代码补全：开始输入一个标志的名称，IDE 会建议一个可用命令行选项的列表。 这适用于  `-XX:` 和  `-X` 选项以及一些未由CLion自动配置的标准选项，例如  `-ea` ，但不适用于  `-cp` 或  `–release` 。       此字段中指定的  `-classpath`  选项将重写模块的类路径。     |

### 日志

以下选项与记录此配置的执行相关。 欲了解更多信息，请参阅 [](null)。

|  项  |  描述  |
| --- | --- |
|     指定要在控制台中显示的日志     |     指定在运行应用程序时显示哪些日志文件。       点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以添加新的日志。 在   编辑日志文件别名  对话框中，配置以下内容：        * 别名 ：显示日志的选项卡的名称。    * 日志文件位置 ：请指定日志文件的路径或 [Ant pattern](https://ant.apache.org/manual/dirtasks.html)。 如果多个滚动日志文件匹配该模式，CLion 将显示最新的一个。    * 显示所有可由模式匹配的文件 ：显示所有符合模式的日志。      对于表格中的日志，您可以配置以下选项：        * 是否激活 ：显示指定的日志文件。    * 跳过内容 ：不要显示以前运行的旧日志消息。    |
|     将控制台输出保存到文件     |  将控制台输出保存到指定位置。 请手动输入路径或点击浏览按钮，并在打开的 [对话框中](select-path-dialog.html)指向所需位置。  |
|     当消息打印到 stdout 时显示控制台     |  当应用程序写入标准输出流时激活控制台。  |
|     当消息打印到 stderr 时显示控制台     |  当应用程序写入标准错误流时激活控制台。  |

### 代码覆盖率

以下选项与代码覆盖率相关。 欲了解更多信息，请参阅 [代码覆盖率](code-coverage-clion.html)。

|  项  |  描述  |
| --- | --- |
|    指定类和包    |  在此表中，指定要测量的类和包。 点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择 ![“添加类”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.class.svg)   添加类   或 ![添加软件包按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.package.png)   添加包   以指定。 您还可以通过在列表中选择类和包，然后点击 ![删除该包](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)按钮来将它们从列表中删除。  |
|    排除类和包    |     指定您要从覆盖作用域中排除的类和包。       点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择 ![“添加类”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.class.svg)   添加类   或 ![添加软件包按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-multiple.html#compound-configs)。    * 运行 Grunt 任务 ：选择此选项来运行 Grunt 任务。 在打开的 Grunt 任务 对话框中，指定定义所需任务的 `Gruntfile.js` ，选择要执行的任务，并指定传递给 Grunt 工具的参数。 指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。    * 运行 Gulp 任务 ：选择此选项以运行 Gulp task。 在打开的 Gulp 任务 对话框中，指定定义所需任务的 `Gulpfile.js` ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。    * 运行 npm 脚本 ：选择此选项来执行 npm 脚本。 在 NPM Script 对话框中，指定 [npm run/debug configuration settings](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为: * 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。 * 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。    |
|     启动时打开运行/调试工具窗口     |     根据配置类型，启动此运行配置时会打开 [运行](run-tool-window.html)、 [调试](debug-tool-window.html)或 [服务](services-tool-window.html)工具窗口。 如果此选项被禁用，您可以手动打开工具窗口：        * `视图 \| 工具窗口 \| 运行` 或 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS))    * `查看 \| 工具窗口 \| 调试` 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS))    * `查看 \| 工具窗口 \| 服务` 或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `⌘ 8` (Xcode), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (ReSharper), `Alt+8` (ReSharper (macOS)), `Alt+8` (QtCreator), `⌘ 8` (QtCreator (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))    |
|     启动时聚焦运行/调试工具窗口     |  在运行测试时，关注运行配置工具窗口。  |
|     启动前显示运行/调试配置设置     |  在实际启动前显示运行配置设置。  |

### Gradle

|  项  |  描述  |
| --- | --- |
|    调试执行图中的所有任务    |     当您选择此选项时，执行图中的每个任务都将被调试。 例如，您尝试调试的任务的所有依赖任务。     |
|    在单独的调试选项卡中调试分叉的 Gradle 任务    |  选择此选项以在 Debug 工具窗口的单独选项卡中运行调试过程。  |
|    以测试方式运行    |     默认情况下，此选项是禁用的。 在这种情况下，CLion 不会打开   运行  工具窗口，并且不会重新运行已更新的测试任务。       但是，如果 CLion 在运行配置中发现测试任务，这些测试任务会在 [Gradle](jetgradle-tool-window.html)工具窗口中突出显示，CLion不会重新运行测试任务，而是打开 Gradle 工具窗口。       从编辑器中使用 ![“运行”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) 在装订区域或上下文菜单中触发测试执行时，此选项将启用。       在这种情况下，CLion 会打开   运行  工具窗口，并且每次触发执行时都会重新运行测试任务，即使这些测试是最新的。       此选项可能有助于控制项目中测试任务的重新运行过程。     |

