# Bazel 目标

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

Bazel  目标 是 Bazel 可构建、运行或测试的单元。 目标作为规则调用被声明在  `BUILD`  或  `构建.bazel`  文件中，并通过类似  `//src/main:app`  的  标签 进行标识，其中  `//src/main`  是软件包，  `app`  是目标名称。

主要目标  类型 有：

* 二进制 （规则以 `_binary` 结尾）会生成可运行或调试的可执行文件。

* Test （以 `_test` 结尾的规则）会生成 runnable 测试，可通过覆盖率执行。

* 库 及其他非可执行文件规则。 这些只能被构建，用作二进制或测试目标的依赖项。

> **Tip:**
> 如需了解 IntelliJ IDEA 中 Bazel 的更详细介绍，请参阅 [教程：Bazel 入门](tutorial-get-started-with-bazel.html)。

## 查找目标

Bazel   工具窗口会列出项目内的所有目标。 这里是浏览、搜索和操作目标的主要位置。 在查找特定目标且未打开源文件或  `BUILD`  文件时可使用此功能。

Procedure: 打开 Bazel 工具窗口

在右侧边栏，点击   Bazel   图标。 或者，从主菜单中选择  `视图 | 工具窗口 | Bazel` 。

![右侧边栏上的 Bazel 工具窗口图标](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-tw-icon.png)

Procedure: 按名称搜索目标

1. 在   Bazel   工具窗口中，点击搜索字段或按下 `Ctrl+F` (Windows), `⌘ F` (macOS), `⌘ F` (IntelliJ IDEA Classic (macOS)), `⌘ F` (macOS System Shortcuts), `Ctrl+F` (XWin), `Ctrl+F` (GNOME), `Ctrl+F` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+F` (Sublime Text), `⌘ F` (Sublime Text (macOS)), `Ctrl+F` (Visual Studio), `⌘ F` (Visual Studio (macOS)), `Ctrl+F` (NetBeans), `Ctrl+F` (Eclipse), `Ctrl+F` (Eclipse (macOS)) 以聚焦。

2. 开始输入部分目标标签。 树中的筛选器会筛选出标签与查询匹配的目标。

![Bazel 工具窗口中的筛选器字段用于对目标树进行筛选器操作](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-search-targets.png)

> **Tip:**
> 也可以使用 [全局搜索](searching-everywhere.html) `Shift Shift` (Windows), `⇧ ⇧` (macOS), `⇧ ⇧` (IntelliJ IDEA Classic (macOS)), `⇧ ⇧` (macOS System Shortcuts), `Shift Shift` (XWin), `Shift Shift` (GNOME), `Shift Shift` (KDE), `Shift Shift` (Emacs), `Shift Shift` (Sublime Text), `⇧ ⇧` (Sublime Text (macOS)), `Shift Shift` (Visual Studio), `⇧ ⇧` (Visual Studio (macOS)), `Shift Shift` (NetBeans), `Shift Shift` (Eclipse), `⇧ ⇧` (Eclipse (macOS)) 快速在整个项目中搜索。 这会展示 Bazel 目标以及名称相似的其他条目。

Procedure: 按类型使用筛选器筛选目标

如果只查找 runnable 或可测试目标，可以使用筛选器进行筛选，隐藏无关目标。

1. 在   Bazel  工具窗口中，点击工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.filter.svg)   过滤器  。

2. 请选择一个选项：

* 所有目标 （默认）

* 仅 runnable ——只保留 `*_binary` 目标。

* 仅可测试 ——只保留 `*_test` 目标。

## 导航至目标并复制其标签。

可以在 IDE 的多个位置使用目标上下文操作：

|  位置  |  可用操作  |
| --- | --- |
|    Bazel   工具窗口  |  右键点击目标并选择   跳转到 BUILD 文件   或   复制目标标签  。  |
|    Bazel 文件目标   微件  |  点击状态栏的微件，展开目标并选择   跳转到 BUILD 文件   或   复制目标标签  。  |
|  编辑器  |  在属于目标的源文件中，右键点击并选择任一操作。 在  `BUILD`  文件中，右键点击规则名称或其  `名称`  实参的值，然后选择   复制目标标签  。  |
|  编辑器选项卡  |  右键点击属于目标的源文件的选项卡，并选择任一操作。 你还可以从  `BUILD`  文件的选项卡中复制标签。  |

使用   跳转到 BUILD 文件   打开目标定义。 当 IntelliJ IDEA 能解析到确切规则时，将在  `BUILD`  文件内打开对应规则调用。 否则将直接打开  `BUILD`  文件本身。

使用   复制目标标签   将目标标签，例如  `//src/main:app` ，复制到剪贴板。

> **Note:**
> 如果当前文件属于多个目标，IntelliJ IDEA 会要求先选择目标。

## 运行、测试、构建和调试目标

不同类型的目标有不同的关联操作：

|  操作  |  应用于  |
| --- | --- |
|  运行  |   `*_binary`  目标  |
|  测试  |   `*_test`  目标  |
|  调试  |   `*_binary`  和  `*_test`  目标  |
|  构建  |  任意目标，包括库  |
|     使用覆盖率运行      > **Tip:** > 有关在 IntelliJ IDEA 中视图覆盖数据的信息，请参阅 [代码覆盖率](code-coverage.html)。    |   `*_test`  目标  |

IntelliJ IDEA 会为每次运行、测试或调试操作创建一个临时 Bazel 运行配置。 如需保存、重命名与配置运行配置，请参阅 [运行/调试配置](run-debug-configuration.html)。

Procedure:

* 在编辑器中：点击相关代码元素旁的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) 装订区域图标，例如  `main()`  入口点或  `BUILD`  文件中的规则调用，然后选择操作。

![装订区域图标弹窗，已选择“运行”操作](https://resources.jetbrains.com/help/img/idea/2026.3/run-bazel-target-from-gutter.png)

* 在   Bazel   工具窗口中：右键点击目标并选择操作。 或者，双击目标：此操作会运行可执行文件目标（二进制和测试），对非可执行文件目标则进行构建。

![Bazel 工具窗口中已选择“运行”上下文菜单项](https://resources.jetbrains.com/help/img/idea/2026.3/run-bazel-target-from-tw.png)

* 在已有的运行配置中：在 [运行微件](new-ui.html#window_header)选择已保存的 Bazel 运行配置，然后选择   运行   或   调试  。

* 在   Bazel 文件目标   微件中：当编辑器中打开与目标相关的文件时，点击状态栏上的该微件，展开目标并选择操作。

![状态栏中的 Bazel 文件目标微件](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-targets-status-bar-widget.png)

一个文件可能关联多个目标。

如果   Bazel 文件目标   微件处于非活动状态，表示插件无法将当前编辑器文件映射到任何 Bazel 目标。 请检查以下内容：

* 当前打开的文件属于已同步的 Bazel 目标

* 未被任何目标 `srcs` 引用的文档、脚本、生成文件和其他源文件即使打开也处于非激活状态。

* 项目已同步。 该微件会从上次项目同步中读取目标信息。 将文件添加到 `srcs` 或编辑 `BUILD` 文件后，请重新同步项目，以便微件获取更改。

### 在目录下运行所有测试

要同时运行或覆盖多个测试目标：

Procedure:

1. 在   Bazel   工具窗口中，定位包含测试目标的目录。

2. 右键点击目录节点，分别选择   运行所有测试   或   使用覆盖率运行所有测试  。

IntelliJ IDEA 会运行该目录下的每个  `*_test`  目标，并合并结果。

### 构建整个项目

要构建所选 [项目视图](bazel-project-view.html)，请转到  `构建 | 构建项目`  或按下 `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))。

## 目标同步设置

如需控制哪些目标可在 IDE 中同步、索引，并可用，请参阅 [Bazel 项目视图](bazel-project-view.html)。

