Bazel Build Optimization

技能概述

为大型单体仓库提供 Bazel 构建优化方案，涵盖构建配置、远程缓存、自定义规则编写和性能调优，帮助企业级代码库实现快速可靠的构建。

适用场景

1. 大型单体仓库构建优化 当您的代码库包含多个项目、多种语言，构建时间成为开发瓶颈时，使用此技能优化 Bazel 构建性能，配置远程缓存和执行，将构建时间从小时级缩短到分钟级。

2. Bazel 构建系统搭建 当您需要为新项目或现有项目引入 Bazel 构建系统时，使用此技能完成 WORKSPACE 配置、BUILD 文件编写、工具链设置和平台配置，建立可扩展的构建基础设施。

3. 构建性能问题诊断与修复 当您的 Bazel 构建出现性能退化、内存占用过高或构建失败时，使用此技能进行依赖分析、构建 profiling、问题定位和修复，恢复构建效率。

核心功能

1. 构建配置与架构设计 提供 WORKSPACE、.bazelrc 和 BUILD 文件的完整配置模板，支持 TypeScript、Python、Java 等多语言项目，包含依赖管理、工具链注册和平台配置的最佳实践。

2. 远程缓存与执行配置 配置 Bazel 远程缓存服务器共享构建产物，实现分布式远程执行提升构建并行度，支持 CI/CD 集成和团队协作场景，大幅减少重复构建时间。

3. 自定义规则与依赖分析 编写 Starlark 自定义规则扩展构建能力，使用 bazel query 进行依赖分析和影响范围评估，通过构建 profiling 识别性能瓶颈。

常见问题

Bazel 适合什么规模的项目？

Bazel 最适合中大型单体仓库和包含多种技术栈的企业项目。如果您的项目构建时间超过 10 分钟、包含多个子项目、需要增量构建和远程缓存，Bazel 是理想选择。对于小型单一语言项目，Bazel 的学习成本可能超过收益。

Bazel 构建太慢怎么优化？

优化 Bazel 构建速度的常见方法包括：启用本地磁盘缓存（--disk_cache）和仓库缓存（--repository_cache），配置远程缓存共享构建产物，调整并发资源设置（--jobs、--local_cpu_resources），使用 bazel query 分析依赖找出不必要的依赖链，以及通过构建 profiling 定位慢的 action。对于超大型项目，建议配置远程执行（--remote_executor）实现分布式构建。

Bazel 远程缓存如何配置？

在 .bazelrc 中添加远程缓存配置：build --remote_cache=grpcs://cache.example.com 并设置 --remote_upload_local_results=true。您可以使用自建的缓存服务（如 bazel-remote）或云服务（如 Google Remote Build Execution）。配置后团队共享构建产物，避免重复构建相同依赖。CI 环境建议同时配置 BES（Build Event Service）以便可视化构建结果。

如何编写自定义 Bazel 规则？

使用 Starlark 语言在 .bzl 文件中定义规则。规则包含 implementation 函数（描述构建逻辑）、attrs（定义属性）和返回值（通常是 DefaultInfo）。例如创建 docker_image 规则需要定义 dockerfile、base_image 等 attributes，在 implementation 中使用 ctx.actions.run 执行构建命令，最后返回输出文件。参考 Template 5 获取完整示例。