为 Bazel 做贡献

为 Bazel 项目和生态系统提供帮助的方式有很多。

提供反馈

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

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

加入社区

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

• 回答 Stack Overflow 上的问题。
• 在 Slack 上帮助其他用户。
• 改进文档或贡献示例。
• 例如在博客或社交媒体上分享您的体验或建议。

贡献代码

Bazel 是一个大型项目，因此对 Bazel 源代码进行更改可能会很困难。

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

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

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

最有用的贡献可以修复 bug 或添加功能（而不是样式、重构或“清理”更改）。您的更改应包含测试和文档，并注意向后兼容性、可移植性以及对内存使用和性能的影响。

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

Bazel 的代码说明

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

Bazel 的结构如下：

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

搜索 Bazel 的源代码

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