IntelliJ IDEA 2025.1 Help

Basel

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

JetBrains Bazel 插件可能对您有用,但尚未准备好用于许多生产环境。 请将您遇到的任何问题报告到我们的 YouTrack 问题跟踪器

安装 Bazel 插件

此功能依赖于 Bazel 插件,您需要安装并启用它。 更多信息请参阅 从 Marketplace 安装插件

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

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 Marketplace 选项卡,找到 Bazel 插件,然后点击 安装

  3. 重启 IDE 以激活插件。

打开项目

打开 Bazel 项目

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

    或者,前往主菜单中的 文件 | 打开

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

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

Bazel 项目同步过程中显示的 Build 工具窗口

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

打开项目子集

由于 Bazel 通常用于大规模项目,您可能希望打开项目子集以减轻 IDE 的负担。 Bazel 插件通常支持由 Google 实现的项目视图文件功能

  • 项目 工具窗口(主菜单中的 Alt+1视图(V) | 工具窗口(T) | 项目 )中,右键点击预定义的项目视图文件并选择 加载项目视图

    Project 工具窗口中 .bazelproject 文件的上下文菜单
  • 或者,在欢迎屏幕上点击 打开 或转到主菜单中的 文件 | 打开 并选择预定义的项目视图文件。

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

当您更改 BUILD WORKSPACE MODULE.bazel 或其他构建定义文件时,IDE 会显示一个弹出窗口,其中包含更新已加载项目结构的按钮。 点击此图标以重新加载项目或按 Ctrl+Shift+O

重新同步弹出窗口和 Bazel 工具窗口

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

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

  2. Basel 工具窗口中,点击 构建并重新同步项目 按钮。

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

构建、运行和调试项目

筛选和搜索目标

Basel 工具窗口中,您可以筛选可运行和可测试的目标。

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

  2. 点击 图标,或通过在搜索字段中键入搜索特定目标。

    重新同步弹出窗口和 Bazel 工具窗口

运行目标

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

  2. 双击目标树中的目标以触发默认操作:运行可运行目标或测试可测试目标。

构建目标

  1. 要构建特定目标,请转到主菜单中的 视图 | 工具窗口 | Bazel

  2. 右键点击目标并选择 构建目标

构建项目

  • 在主菜单中,前往 构建 | 构建项目 或按 Ctrl+F9

构建项目 操作构建所有目标。

设置运行配置

每当您运行 Bazel 目标时,插件会自动创建一个临时的 运行配置 ,您可以根据需要进行编辑。

  1. 在主菜单中,转到 运行 | 编辑配置 或使用 IDE 窗口标题中的 运行小部件

    运行配置列表中选择了 Edit Configurations
  2. 选择一个运行配置。

    在右侧部分,根据需要更改设置。

运行测试

  • 点击编辑器边栏中您要运行的测试旁边的 图标。

  • 或者,在 Basel 工具窗口中右键点击目标并选择 使用 Bazel 测试

代码中带有图标的边栏和目标的上下文菜单,选择了“使用 Bazel 测试”

Starlark 支持

Bazel 插件在 Starlark 文件中提供代码补全和导航功能:

Starlark 文件中的代码补全建议

调试 Starlark 代码

  1. 设置断点

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

    在 IntelliJ IDEA 中调试 Starlark 代码
最后修改日期: 2025年 4月 24日