# Bazel

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

[Bazel](https://bazel.build/) 是 Google 开发的开源构建和测试工具。 它旨在管理跨多种语言和平台、具有复杂依赖关系的大型代码库。 Bazel 自动化了编译代码、链接依赖项、运行测试和部署工件的过程。

Procedure: 安装 Bazel 插件

此功能性依赖于 [Bazel](https://plugins.jetbrains.com/plugin/22977-bazel) 插件，您需要安装并启用该插件。 更多信息请参阅 [从 Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)。

Bazel 支持基于通用的 Build Server Protocol (BSP) 实现，该协议将多种构建工具与 IDE 集成。 该协议作为一个单独的插件提供，与 JetBrains Bazel 插件一起自动安装。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Bazel  插件，然后点击   安装  。

3. 重启 IDE 以激活插件。

## 打开项目

Procedure: 打开 Bazel 项目

1. 在欢迎屏幕上，点击   打开  。

或者，前往主菜单中的  `文件 | 打开` 。

2. 在打开的对话框中，指定项目源的路径。

您可以在   构建   工具窗口中查看导入项目的过程：

![Bazel 项目同步过程中显示的 Build 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-sync-build-tool.png)

打开 Bazel 项目目录将创建一个默认的项目视图文件  `projectview .bazelproject` ，该文件加载整个工作区。

Procedure: 打开项目子集

由于 Bazel 通常用于大规模项目，您可能希望打开项目子集以减轻 IDE 的负担。 Bazel 插件通常支持由 Google 实现的项目视图文件功能 [。](https://ij.bazel.build/docs/project-views.html)

* 在   项目   工具窗口（主菜单中的 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 或  `视图 | 工具窗口 | 项目` ）中，右键点击预定义的项目视图文件并选择   加载项目视图  。

![Project 工具窗口中 .bazelproject 文件的上下文菜单](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-load-project-view.png)

* 或者，在欢迎屏幕上点击   打开  ，或转到主菜单中的  `文件 | 打开`  并选择预定义的项目视图文件。

### 在文件更改时重新同步项目

当您更改  `BUILD` 、  `WORKSPACE` 、  `MODULE.bazel`  或其他构建定义文件时，IDE 会显示一个弹出窗口，其中包含更新已加载项目结构的按钮。 点击此图标以重新加载项目，或按 `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS))。

![重新同步弹出窗口和 Bazel 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-sync-popup-and-window.png)

您还可以使用   Bazel   工具窗口重新加载项目。

Procedure:

1. 在主菜单中，前往  `视图 | 工具窗口 | Bazel` 。

2. 在   Bazel   工具窗口中，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.toolwindows.settingSync.svg)   构建并重新同步项目   按钮。

构建并重新同步项目   选项还会在同步过程中运行完整构建。 这确保了所有生成的源依赖项可用。

## Starlark 支持

Bazel 插件在 [Starlark](https://bazel.build/rules/language) 文件中提供代码补全和导航功能：

![Starlark 文件中的代码补全建议](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-starlark-completion.png)

Procedure: 调试 Starlark 代码

1. [设置断点](using-breakpoints.html#set-breakpoints)，在  `.bzl`  文件中。

2. 右键点击   Bazel   工具窗口中的相应目标并选择   Starlark 调试  。

![在 IntelliJ IDEA 中调试 Starlark 代码](https://resources.jetbrains.com/help/img/idea/2026.3/bazel-starlark-debug.png)

