为 Bazel 做贡献

报告问题 查看源代码 每晚

您可以通过多种方式为 Bazel 项目和生态系统提供帮助。

提供反馈

在使用 Bazel 的过程中,您可能会发现一些可以改进的地方。在以下情况下,您可以通过报告问题来帮助解决这个问题:

  • Bazel 崩溃,或者您遇到只能使用 bazel clean 才能解决的 bug。
  • 文件不完整或不清楚。您还可以使用页面右上角的“创建问题”链接,报告您正在查看的页面中的问题。
  • 错误消息需要改进。

加入社区

您可以通过以下方式与 Bazel 社区互动:

贡献代码

Bazel 是一个大型项目,更改 Bazel 源代码可能很困难。

您可以通过以下方式为 Bazel 生态系统做贡献:

  • 通过贡献拉取请求帮助规则维护者。
  • 创建新规则并开放其源代码。
  • 贡献与 Bazel 相关的工具,例如迁移工具。
  • 改进 Bazel 与其他 IDE 和工具的集成。

在进行更改之前,请创建 GitHub 问题或发送电子邮件至 bazel-comment@

最有用的贡献会修复 bug 或添加功能(与样式、重构或“清理”更改相反)。您的更改应包括测试和文档,要注意向后兼容性、可移植性以及对内存用量和性能的影响。

如需了解如何提交更改,请参阅补丁接受流程

Bazel 的代码说明

Bazel 有一个大型代码库,其中的代码位于多个位置。如需了解详情,请参阅代码库指南

Bazel 的组织方式如下:

  • 客户端代码位于 src/main/cpp 中,并提供命令行界面。
  • 协议缓冲区位于 src/main/protobuf 中。
  • 服务器代码位于 src/main/javasrc/test/java 中。
    • 核心代码,主要由 SkyFrame 和一些实用程序组成。
    • 内置规则位于 com.google.devtools.build.lib.rulescom.google.devtools.build.lib.bazel.rules 中。您可能需要先了解编写规则所面临的挑战
  • Java 原生接口位于 src/main/native 中。
  • 编译 Bazel 部分中的列表介绍了各种语言支持工具。

搜索 Bazel 的源代码

要快速搜索 Bazel 的源代码,请使用 Bazel 代码搜索。您可以浏览 Bazel 的代码库、分支和文件您还可以查看历史记录、差异和责任信息。如需了解详情,请参阅 Bazel 代码搜索用户指南