本页介绍了如何使用宏和规则扩展 BUILD 语言。
Bazel 扩展程序是以 .bzl 结尾的文件。使用
load 语句从扩展程序导入符号。
在学习更高级的概念之前，请先执行以下操作：
了解 Starlark 语言，用于
BUILD和.bzl文件。了解如何在两个
BUILD文件之间共享变量。
宏和规则
宏是实例化规则的函数。宏有两种类型：
符号宏（Bazel 8 中的新功能）和旧版
宏。这两种类型的宏的定义方式不同，但从用户的角度来看，其行为几乎相同。当 BUILD 文件变得过于重复或过于复杂时，宏非常有用，因为它可以让您重复使用一些代码。系统会在读取 BUILD 文件后立即对该函数求值。在对 BUILD 文件求值后，Bazel 几乎没有关于宏的信息。如果您的宏生成 genrule，Bazel 的行为 几乎 与您在 BUILD 文件中声明该 genrule 的行为相同。（唯一的
例外是，在符号宏中声明的目标具有特殊的可见性
语义：符号宏可以向软件包的其余部分隐藏其内部
目标。）
规则比宏更强大。它可以访问 Bazel 内部结构，并完全控制正在发生的事情。例如，它可以将信息传递给其他规则。
如果您想重复使用简单的逻辑，请从宏开始；我们建议使用符号宏，除非您需要支持旧版 Bazel。如果宏变得复杂，通常最好将其设为规则。对新语言的支持通常通过规则完成。规则适用于高级用户，大多数用户永远不必编写规则；他们只会加载和调用现有规则。
评估模型
构建包含三个阶段。
加载阶段 。首先，加载并评估构建所需的所有扩展程序和所有
BUILD文件。BUILD文件的执行只是实例化规则（每次调用规则时，都会将其添加到图中）。在此阶段，系统会对宏进行评估。分析阶段 。系统会执行规则的代码（其
implementation函数），并实例化操作。操作描述了如何从一组输入生成一组输出，例如“在 hello.c 上运行 gcc 并获取 hello.o”。您必须在执行实际命令之前明确列出将生成哪些文件。换句话说，分析阶段会获取加载阶段生成的图，并生成操作图。执行阶段 。当需要至少一个操作的输出时，系统会执行这些操作。如果缺少文件或命令无法生成输出，构建就会失败。在此阶段，系统还会运行测试。
Bazel 使用并行处理来读取、解析和评估 .bzl 文件和 BUILD 文件。每个文件在每次构建中最多读取一次，并且评估结果会被缓存并重复使用。只有在解析完文件的所有依赖项（load() 语句）后，系统才会对该文件进行评估。按照设计，加载 .bzl 文件没有明显的副作用，它只会定义值和函数。
Bazel 会尝试变得更智能：它使用依赖项分析来了解必须加载哪些文件、必须分析哪些规则以及必须执行哪些操作。例如，如果某条规则生成了当前构建不需要的操作，则不会执行这些操作。
创建扩展程序
创建您的第一个宏，以便重复使用一些代码。 然后，详细了解宏以及如何使用宏创建 “自定义动词”。
在编写自己的扩展程序时，以下两个链接非常有用。请将它们放在方便访问的位置：