# 构建工具窗口

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

> **TL;DR**
> `查看 | 工具窗口 | 构建`

构建   工具窗口可帮助您查看由 [IntelliJ IDEA](compiling-applications.html) 完成、委托给 [Maven](delegate-build-and-run-actions-to-maven.html#delegate_to_maven) 或 [Gradle](work-with-gradle-projects.html#delegate_build_gradle) 的构建输出，以及项目同步结果。

构建代码后，该工具窗口将可用。

## 构建输出选项卡

IntelliJ IDEA 在   构建输出   选项卡中显示您的构建结果。 根据项目的不同，构建输出会显示已执行的任务、目标和命令以及生成的错误信息。

默认情况下，该选项卡还会显示所有成功步骤和警告。

Procedure: 构建项目

1. 在主菜单中，转到  `构建 | 构建项目`  或按 `Ctrl+F9` (Windows), `⌘ F9` (macOS), `⌘ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ B` (macOS System Shortcuts), `Ctrl+F9` (XWin), `Ctrl+F9` (GNOME), `Ctrl+9` (KDE), `Ctrl+F9` (Emacs), `Ctrl+F9` (Sublime Text), `Ctrl+F9` (Sublime Text (macOS)), `F7` (Visual Studio), `F7` (Visual Studio (macOS)), `F11` (NetBeans), `Ctrl+F9` (Eclipse), `⌘ B` (Eclipse (macOS))。

2. 在   构建   工具窗口中查看结果。

如果工具窗口未自动打开，请在主菜单中转到  `查看 | 工具窗口 | 构建` 。

IntelliJ 构建器:

![IntelliJ IDEA 构建输出](https://resources.jetbrains.com.cn/help/img/idea/2026.3/buildOutputJava.png)

Gradle:

![Gradle 构建输出](https://resources.jetbrains.com.cn/help/img/idea/2026.3/gradle_build_output.png)

Maven:

![Maven 构建输出](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_build_output.png)

## 同步选项卡

当您打开 [Gradle](gradle.html#gradle_import_project_start) 或 [Maven](maven-support.html#maven_import_project_start) 项目时，同步会自动完成。

如果需要，您可以手动触发项目的同步。

Procedure: 重新导入项目

1. 打开 [Gradle](jetgradle-tool-window.html) 或 [Maven](maven-projects-tool-window.html) 工具窗口。

2. 右键点击要同步的项目，然后从上下文菜单中为 Maven 选择   同步项目  ，或为 Gradle 选择   重新加载 Gradle 项目  。

3. 在   构建   工具窗口中查看结果。

Gradle:

![构建工具窗口：同步选项卡](https://resources.jetbrains.com.cn/help/img/idea/2026.3/gradle_build_tool_window_sync.png)

Maven:

![构建工具窗口：同步选项卡](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_sync_tab.png)

如需了解更多信息，请参阅 [Maven](delegate-build-and-run-actions-to-maven.html#maven_reimport) 和 [Gradle](work-with-gradle-projects.html#gradle_refresh_project) 部分。

## 错误处理

当构建过程出现错误时，IntelliJ IDEA 会显示一个带有行号和列号的错误信息，便于快速定位。 如果 IntelliJ IDEA 可以定位错误位置，则会显示一个链接，点击该链接即可导航到编辑器中的相应行。

IntelliJ 构建器:

![构建工具窗口：错误导航](https://resources.jetbrains.com.cn/help/img/idea/2026.3/idea_error_output.png)

Gradle:

![构建工具窗口：错误导航](https://resources.jetbrains.com.cn/help/img/idea/2026.3/gradle_error_navigation.png)

Maven:

![构建工具窗口：错误导航](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_error_navigation.png)

当   构建  工具窗口显示多个错误或警告时，您可以从 [上下文菜单](#build_context_menu)或使用 `Ctrl+Alt+Down` (Windows), `⌘ ⌥ ↓` (macOS), `⌘ ⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↓` (macOS System Shortcuts), `Ctrl+Alt+Down` (XWin), `Alt+Shift+Down` (GNOME), `Ctrl+Alt+Down` (KDE), `Ctrl+Alt+Down` (Emacs), `Ctrl+Alt+Down` (Sublime Text), `Ctrl+Alt+Down` (Sublime Text (macOS)), `Ctrl+Alt+Down` (Visual Studio), `⌘ ⌥ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Alt+Down` (Eclipse), `Ctrl+Alt+Down` (Eclipse (macOS))和 `Ctrl+Alt+Up` (Windows), `⌘ ⌥ ↑` (macOS), `⌘ ⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↑` (macOS System Shortcuts), `Ctrl+Alt+Up` (XWin), `Alt+Shift+Up` (GNOME), `Ctrl+Alt+Up` (KDE), `Ctrl+Alt+Up` (Emacs), `Ctrl+Alt+Up` (Sublime Text), `Ctrl+Alt+Up` (Sublime Text (macOS)), `Ctrl+Alt+Up` (Visual Studio), `⌘ ⌥ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Alt+Up` (Eclipse), `Ctrl+Alt+Up` (Eclipse (macOS))快捷键在下一个或上一个问题之间导航。

如果错误发生在同步过程中，IntelliJ IDEA 会显示一条错误信息。 IntelliJ IDEA 还会在文本控制台中显示问题描述，并在可能的情况下提供解决方案。

Gradle:

![构建工具窗口：错误消息](https://resources.jetbrains.com.cn/help/img/idea/2026.3/gradle_error_message.png)

Maven:

![构建工具窗口：错误消息](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_message_error.png)

## 上下文菜单

多种选项如   重新运行   和   停止   与 [侧边工具栏](#side_toolbar) 中相同，其余选项在下表中描述：

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|    跳转到源    |  `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))  |  在编辑器中打开对应位置。  |
|    显示警告    |  |  选择此选项以显示 IntelliJ IDEA 的警告。  |
|    显示成功步进步骤    |  |  选择此选项以显示 IntelliJ IDEA 的所有构建过程步骤。  |
|    从编译中排除    |  |  将相关文件排除在编译之外。  |
|    从验证中排除    |  |  将相关文件从验证中排除。  |
|    上一个问题    |  `Ctrl+Alt+Up` (Windows), `⌘ ⌥ ↑` (macOS), `⌘ ⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↑` (macOS System Shortcuts), `Ctrl+Alt+Up` (XWin), `Alt+Shift+Up` (GNOME), `Ctrl+Alt+Up` (KDE), `Ctrl+Alt+Up` (Emacs), `Ctrl+Alt+Up` (Sublime Text), `Ctrl+Alt+Up` (Sublime Text (macOS)), `Ctrl+Alt+Up` (Visual Studio), `⌘ ⌥ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Alt+Up` (Eclipse), `Ctrl+Alt+Up` (Eclipse (macOS))  |  导航到上一个问题。  |
|    下一个问题    |  `Ctrl+Alt+Down` (Windows), `⌘ ⌥ ↓` (macOS), `⌘ ⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↓` (macOS System Shortcuts), `Ctrl+Alt+Down` (XWin), `Alt+Shift+Down` (GNOME), `Ctrl+Alt+Down` (KDE), `Ctrl+Alt+Down` (Emacs), `Ctrl+Alt+Down` (Sublime Text), `Ctrl+Alt+Down` (Sublime Text (macOS)), `Ctrl+Alt+Down` (Visual Studio), `⌘ ⌥ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Alt+Down` (Eclipse), `Ctrl+Alt+Down` (Eclipse (macOS))  |  导航到下一个问题。  |

对于在输出右侧显示的消息的上下文菜单中的选项，请使用下表：

|  条目  |  描述  |
| --- | --- |
|    与剪贴板比较    |  在内置的 差异查看器 中比较输出。  |
|    折叠此类行    |  您可以折叠过长的行。  |
|    暂停输出    |  暂停编译过程。  |
|    全部清除    |  删除输出消息。  |

## 侧边工具栏按钮

|  图标  |  工具提示  |  描述  |
| --- | --- | --- |
|  ![重新运行](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.build.build.svg)  |    重新运行    |  重新运行编译。  |
|  ![停止](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.stop.svg)  |    停止    |  停止构建过程。    终止编译。 当编译进行时，此按钮启用。     |
|  ![编译器属性](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)  |    编译器属性    |  [配置](specifying-compilation-settings.html) [编译器设置](compiler.html)。  |
|  ![Pin 图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.pin.svg)  |    固定选项卡    |  将您正在使用的选项卡固定。 下次构建代码时，结果将显示在新选项卡中。  |
|  ![筛选器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.inspections.inspectionsEye.svg)  |    筛选器    |  过滤显示或隐藏警告和成功步骤的输出。  |
|  ![软换行](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.softWrap.svg)  |    自动换行    |  在消息文本中创建软换行符。  |
|  ![滚动到末尾](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.scrollDown.svg)  |    滚动到末尾    |  滚动到显示消息的末尾。  |

## 上方工具栏按钮

|  图标  |  工具提示  |  描述  |
| --- | --- | --- |
|  ![显示选项菜单](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)  |    显示选项菜单    |  点击此图标可打开一个菜单，其中包含用于管理工具窗口的更多选项，例如显示或隐藏侧边工具栏、对选项卡进行分组、选择视图模式、调整大小等。  |
|  ![隐藏](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.hideToolWindow.svg)  |    隐藏    |  隐藏工具窗口。 要再次打开它，请在主菜单中转到  `查看 \| 工具窗口 \| 构建` 。  |