# Gradle 工具窗口

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

`视图 | 工具窗口 | Gradle`

当您 [创建 或 打开](gradle-support.html) Gradle 项目时，Gradle 工具窗口会自动启用。 工具窗口显示了 Gradle 关联项目、其任务、依赖项以及对基础  `构建.gradle` 文件所做的所有更改。

> **Note:**
> 如果您从侧边栏中移除了 Gradle 工具窗口，请从主菜单中选择  `视图 | 工具窗口 | Gradle`  重新打开它。

## Gradle

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![显示选项菜单](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg)  |  |     点击此按钮以打开菜单配置当前视图并更改工具窗口查看模式。 菜单项是您可以开启或关闭的选项。 活动项在其名称的左侧包含一个复选标记。       菜单中可用的选项如下：        * 分组模块 ：如果您想在项目中分组模块，请选择此选项。    * 群组任务 ：如果您想对任务进行分组，请选择此选项。 例如，构建任务将包含在 构建 目录中。    * 显示忽略 ：选择此选项以显示已忽略的项目。    * 显示工具栏 ：选择此选项以显示您的 Gradle 项目的工具栏。    * 固定、停靠、浮动、拆分模式——这些选项允许您控制工具窗口的外观和行为，请参阅 [工具窗口查看模式](viewing-modes.html)。    * 分组选项卡 ：如果工具窗口中有多个视图，取消选择该选项可在不同的选项卡上查看视图。    * 移动到 ：选择此选项以将 Gradle 工具窗口移动到顶部、左侧或右侧。    * 调整大小 ：选择此选项可调整 Gradle 工具窗口的大小。    |
|  ![隐藏工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.hide.svg)  |  `Shift+Escape` (Windows), `⇧ ⎋` (macOS), `⇧ ⎋` (IntelliJ IDEA Classic (macOS)), `⇧ ⎋` (macOS System Shortcuts), `Shift+Escape` (XWin), `Shift+Escape` (GNOME), `Shift+Escape` (KDE), `Shift+Escape` (Emacs), `Shift+Escape` (Sublime Text), `⇧ ⎋` (Sublime Text (macOS)), `⇧ ⎋` (Xcode), `Shift+Escape` (Visual Studio), `⇧ ⎋` (Visual Studio (macOS)), `Shift+Escape` (ReSharper), `⇧ ⎋` (ReSharper (macOS)), `Shift+Escape` (QtCreator), `⇧ ⎋` (QtCreator (macOS)), `Shift+Escape` (NetBeans), `Shift+Escape` (Eclipse), `⇧ ⎋` (Eclipse (macOS))  |     隐藏工具窗口 `Shift+Escape` (Windows), `⇧ ⎋` (macOS), `⇧ ⎋` (IntelliJ IDEA Classic (macOS)), `⇧ ⎋` (macOS System Shortcuts), `Shift+Escape` (XWin), `Shift+Escape` (GNOME), `Shift+Escape` (KDE), `Shift+Escape` (Emacs), `Shift+Escape` (Sublime Text), `⇧ ⎋` (Sublime Text (macOS)), `⇧ ⎋` (Xcode), `Shift+Escape` (Visual Studio), `⇧ ⎋` (Visual Studio (macOS)), `Shift+Escape` (ReSharper), `⇧ ⎋` (ReSharper (macOS)), `Shift+Escape` (QtCreator), `⇧ ⎋` (QtCreator (macOS)), `Shift+Escape` (NetBeans), `Shift+Escape` (Eclipse), `⇧ ⎋` (Eclipse (macOS))。       要隐藏所有工具窗口，请按 `Ctrl+Shift+F12` (Windows), `⌘ ⇧ F12` (macOS), `⌘ ⇧ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F12` (macOS System Shortcuts), `Ctrl+Shift+F12` (XWin), `Ctrl+Shift+F12` (GNOME), `Ctrl+Shift+F12` (KDE), `Ctrl+Shift+F12` (Emacs), `Ctrl+Shift+F12` (Sublime Text), `⌘ ⇧ F12` (Sublime Text (macOS)), `⌘ ⇧ F12` (Xcode), `Ctrl+Shift+F12` (Visual Studio), `⌘ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Shift+F12` (ReSharper), `⌘ ⇧ F12` (ReSharper (macOS)), `Ctrl+Shift+F12` (QtCreator), `⌘ ⇧ F12` (QtCreator (macOS)), `Ctrl+Shift+F12` (NetBeans), `Ctrl+Shift+F12` (Eclipse), `⌘ ⇧ F12` (Eclipse (macOS))。     |

## Gradle 任务

|  项  |  描述  |
| --- | --- |
|  运行配置  |  此区域包含最后执行的任务列表以及这些任务执行时的命令类型。  |
|  任务  |  此区域包含所有可用任务的列表。  |
|  依赖项  |  此区域包含项目依赖项列表。  |

## 工具栏

|  项  |  描述  |
| --- | --- |
|  ![重新导入所有 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.refresh.svg)  |  点击此按钮以在对 Gradle 脚本进行更改后重新导入所有已注册的 Gradle 项目。  |
|  ![取消 Gradle 项目链接](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  点击此按钮以 [分离](null)外部 Gradle 项目。  |
|  ![下载源代码](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.download.svg)  |  点击此按钮以手动下载初始项目同步中未下载的项目依赖项源。 如果您希望始终为项目下载这些来源，请在   下载源代码  中使用 [构建工具。 Gradle](advanced-settings.html#build_tools_gradle)选项。  |
|  ![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.consoleRun.svg)  |  请使用此按钮 [执行 Gradle 任务](null)。 当您点击此图标时，   运行任意内容   窗口将打开。 请输入您要执行的任务名称。 要执行多个任务，请使用空格分隔每个任务名称。  |
|  ![全部展开](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.expandAll.svg) ![全部折叠](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.collapseAll.svg)  |  请使用这些按钮展开或折叠所有节点。  |
|  ![选择要导入的项目数据](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.moduleGroup.svg)  |  点击此按钮，通过 [项目数据导入](gradle-project-data-to-import-dialog.html)对话框将模块或数据导入到您的 Gradle 项目中。 它可能对多模块项目有用。  |
|  ![切换离线模式](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.build.toggleOfflineMode.svg)  |  点击此按钮以在 [offline mode](working-offline.html#gradle)下处理 Gradle 项目。 在这种情况下，Gradle 将使用缓存中的依赖项。 Gradle 将不会尝试访问网络来执行依赖解析。 如果所需的依赖项不在缓存中，构建执行将失败。 此外，如果启用离线模式，则可能会导致项目的打开和同步失败。  |
|  ![构建工具设置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |     使用此图标访问以下设置：        * 自动重载设置 ：选择此选项以在 [构建工具设置](settings-build-tools.html)对话框中配置 Gradle 项目的重新加载过程。    * Gradle 设置 ：选择此选项以在 [Gradle 设置](gradle-settings.html)对话框中配置当前 Gradle 项目的设置。    |

## 上下文菜单

|  项  |  描述  |
| --- | --- |
|  ![打开 Gradle 配置](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.expui.gradle.svg)  |  选择此选项或使用快捷键打开  `构建.gradle` 文件。  |
|  ![重新导入 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.refresh.svg)  |  选择此选项以 [重新导入](null) 项目。  |
|  ![解除 Gradle 项目链接](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  选择此选项以 [分离](null) 外部项目。  |
|  忽略 Gradle 项目  |  选择此选项以忽略/取消忽略所选项目。  |
|  刷新 Gradle 依赖项  |  选择此选项以刷新项目的依赖项。  |
|  显示依赖关系 / 显示依赖关系弹出窗口  |  请使用这些选项生成 Gradle 依赖关系图。  |
|  任务激活  |  选择此选项以添加、编辑或删除任务的激活阶段。 这可能对处理 Gradle 多模块项目有用。  |

## 用于 Gradle 任务的上下文菜单命令

|  命令  |  描述  |
| --- | --- |
|  运行 <task>  |  选择此命令以使用任务特定的运行/调试配置 [运行所选任务](null)。  |
|  调试 <task>  |  选择此命令以使用特定任务的运行/调试配置 [调试选定的任务](null)。  |
|  创建<task>  |  选择此命令为所选的 Gradle 任务 [创建运行/调试配置](null)。  |
|  选择<task>  |  选择此命令以激活所选 Gradle 任务的配置。 如果所选任务没有现有的配置，该选项将被禁用并替换为   创建   选项。  |
|  同步前执行，同步后执行  |  选择这些命令来为所选任务设置相应的标志。 在这种情况下，  Before Sync  和  After Sync  注释出现在节点名称旁边。  |
|  在构建之前执行，在构建之后执行  |  选择这些命令来为所选任务设置相应的标志。 在这种情况下，“  Before 构建 ”和“  After 构建 ”注释出现在节点名称旁边。  |
|  重建前执行，重建后执行  |  选择这些命令来为所选任务设置相应的标志。 在这种情况下，  Before Re构建  和  After Re构建  注释会出现在节点名称旁边。  |
|  分配快捷键  |  选择此命令以将所选阶段与键盘快捷键关联。 在这种情况下，带有快捷方式的注释会出现在节点名称旁边。  |

## See also

### 快速开始

[工具窗口](tool-windows.html)

### 流程

[Gradle](gradle-support.html)

### 外部链接

[Gradle](http://gradle.org/)

