发布模型

<ph type="x-smartling-placeholder"></ph> 报告问题 查看来源 敬上 每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5

正如原始博客中所宣布的那样， 发布，Bazel 4.0 及更高版本支持两种发布方式：滚动 和长期支持 (LTS) 版本。本页介绍了 有关 Bazel 发布模型的信息

支持矩阵

LTS 版本 支持阶段 最新版本 停止提供支持
Bazel 8 滚动 查看滚动发布页面 不适用
Bazel 7 有效 7.3.1 2026 年 12 月
Bazel 6 维护 6.5.0 2025 年 12 月
Bazel 5 维护 5.4.1 2025 年 1 月
Bazel 4 已弃用 4.2.4 2024 年 1 月

所有 Bazel LTS 版本都可以在版本 页面。

发布版本版本控制

Bazel 使用 major.minor.patch 语义 版本控制方案。

  • 主要版本包含与 先前版本。每个主要 Bazel 版本都是一个 LTS 版本。
  • 次要版本包含向后兼容的 bug 修复和功能 从 main 分支向后移植。
  • 补丁版本包含重要的 bug 修复。

此外，预发布版本会以 日期后缀。

例如，每种类型的新版本都将生成以下版本号：

  • 主要：6.0.0
  • 次要版本：6.1.0
  • 补丁：6.1.2
  • 预发布：7.0.0-pre.20230502.1

支持阶段

对于每个主要 Bazel 版本，都有四个支持阶段：

  • 滚动：此主要版本仍处于预发布阶段，Bazel 团队 从 HEAD 发布滚动版本。
  • 有效：此主要版本是当前有效的 LTS 版本。Bazel 团队将重要功能和问题修复向后移植到次要版本中。
  • 维护：此主要版本是正在维护的一个 LTS 版本 模式。Bazel 团队只承诺 安全问题和操作系统兼容性问题。
  • 已弃用：Bazel 团队不再为此主要资源提供支持 则所有用户都应迁移到较新的 Bazel LTS 版本。

发布频率

Bazel 会定期发布两个发布轨道的版本。

滚动版本

  • 滚动版本与 Google Blaze 版本协调， 。这是下一个 Bazel LTS 的预览版 发布。
  • 滚动版本可能包含不兼容的更改。不兼容的标志是 推荐用于重大破坏性更改、推出不兼容的更改 应遵循我们的向后兼容性 政策。

LTS 版本

  • 主要版本：新的 LTS 版本预计将从 HEAD 中大幅削减 每 12 个月。新的 LTS 版本发布后，会立即进入有效 阶段，而上一个 LTS 版本将进入维护阶段。
  • 次要版本：活跃 LTS 轨道上的新的次要版本预计 每 2 个月发布一次。
  • 补丁版本：适用于 LTS 版本的活跃补丁和 预计会针对严重 bug 按需发布维护阶段 修复。
  • Bazel LTS 版本进入“弃用”阶段后， 维护阶段为 2 年。

如需了解计划发布的版本，请查看我们的版本 期 。

发布流程和政策

对于滚动发布，流程非常简单：大约每两周发布一次 根据与 Google 内部 Blaze 版本。由于发布时间表较快，我们不会向后移植任何更改 和滚动发布。

对于 LTS 版本，请遵循以下流程和政策：

  1. 确定版本的基准提交。
    • 对于新的主要 LTS 版本，基准提交是主 LTS 版本的 HEAD 分支。
    • 对于次要版本或补丁版本，基准提交是 同一 LTS 版本的当前最新版本。
  2. 使用基准中的 release-<version> 名称创建一个版本分支 commit。
  3. 通过 PR 将更改向后移植到版本分支。
    • 社区可以通过回复评论来建议向后移植的特定提交内容 “@bazel-io flag”在相关 GitHub 问题或 PR 上将其标记为潜在 则 Bazel 团队会对这些障碍进行分类，并决定是否 向后移植提交的内容
    • 只有主分支上的向后兼容提交才能向后移植， 接受其他细微更改来解决合并冲突。

  4. 针对 Bazel 维护者，使用 Cherry-Pick Request 问题向后移植更改。

    • Bazel 维护人员可以请求择优挑选特定的提交 添加到某个版本分支该流程通过创建 GitHub 上的择优挑选请求。以下是操作方法。

      1. 打开择优挑选请求
      2. 填写请求详情 <ph type="x-smartling-placeholder">
          </ph>
        • 标题：为请求提供简明扼要的描述性标题。
        • 提交 ID：输入您想要执行的提交的 ID 择优挑选如果存在多项提交，则将 以逗号分隔。
        • 类别：指定请求的类别。
        • 审核者：如果有多个审核者，请将他们的 GitHub 分隔开来 以逗号分隔 ID。
      3. 设置里程碑 <ph type="x-smartling-placeholder">
          </ph>
        • 查找“里程碑”部分，然后点击相应设置。
        • 选择相应的 X.Y.Z 版本拦截器。此操作 触发择优挑选机器人处理你的请求 “release-X.Y.Z”分支。
      4. 提交问题 <ph type="x-smartling-placeholder">
          </ph>
        • 填写完所有详细信息并设置里程碑后， 提交问题。

    • 择优挑选机器人将会处理该请求并通知 如果提交符合择优挑选的条件。如果 提交的内容是可择优挑选的 择优挑选提交时存在合并冲突，然后 聊天机器人将创建新的拉取请求拉取 请求获得 Bazel 团队成员批准后， 系统会择优挑选提交内容并将其合并到版本分支中。 如需查看已完成择优挑选请求的直观示例， 参阅这篇 示例 ，了解所有最新动态。

  5. 找出版本障碍，并修复在版本分支中发现的问题。

  6. 在已知版本分支的情况下，根据新的候选版本创建新的候选版本 版本拦截器已得到解决。

    • 候选版本宣布于 bazel-COMMENT、 Bazel 团队会监控候选者的社区 bug 报告。
    • 如果发现新的发布阻碍，请返回上一步并 解决所有问题后创建新的候选版本。
    • 版本分支发布后，就不允许再向版本分支添加新特性 首个候选版本创建完成择优挑选仅限于 修复。如果需要择优挑选，请求者必须回答 为什么说此次变更至关重要，有什么好处 该怎么办？这项变更可能导致 回归？

  7. 如果没有其他版本，则将候选版本作为正式版本推送 已发现障碍

    • 对于补丁版本，请在发布至少 2 个工作日后推送版本 最后一个候选版本已发布
    • 对于主要和次要版本，请在两个工作日后推送版本 候选版本已推出，但不要早于该日期的一周后 第一个候选版本已发布
    • 仅在次日为企业推出版本 。
    • 该版本的发布时间为 bazel-COMMENT、 Bazel 团队会监控并处理社区 bug 报告， 发布。

报告回归问题

如果用户在新的 Bazel 版本、候选版本甚至 HEAD 的 Bazel，请报告以下 bug： GitHub您可以使用 Bazelisk 对引发罪魁祸首的提交进行二分法处理，并将此信息包含在 bug 中 报告。

例如，如果构建使用 Bazel 6.1.0 成功，但第二个 候选版本 6.2.0，则可以通过以下代码

bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar

您可以将 BAZELISK_SHUTDOWN 或 BAZELISK_CLEAN 环境变量设置为运行 根据需要使用相应的 bazel 命令重置构建状态 重现问题。如需了解详情，请参阅有关 Bazelisk 的文档 bisect 特征。

记得将 Bazelisk 升级到最新版本才能使用 bisect 功能。

规则兼容性

如果您是规则的创建者，并希望保持与 Bazel 版本，请参阅规则 兼容性页面。