bazel-build-optimization

Bazel Build Optimization

技能概述

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

适用场景

大型单体仓库构建优化

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

Bazel 构建系统搭建

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

构建性能问题诊断与修复

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

核心功能

构建配置与架构设计

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

远程缓存与执行配置

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

自定义规则与依赖分析

编写 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 获取完整示例。