常见定义

标签列表；默认值为 []

此规则在运行时所需的文件。可以列出文件或规则目标。通常允许任何目标。

data 属性中目标的默认输出和 runfile 应显示在由此目标输出或对该目标具有运行时依赖项的任何可执行文件的 *.runfiles 区域中。这可能包括执行此目标的 srcs 时使用的数据文件或二进制文件。如需详细了解如何依赖和使用数据文件，请参阅数据依赖项部分。

新规则在处理可能在运行时使用其他输入的输入时，应定义 data 属性。规则的实现函数还必须从任意 data 属性的输出和 runfile，以及来自提供源代码或运行时依赖项的任何依赖项属性的 runfile 填充目标的 runfile。

标签列表；默认值为 []

此目标的依赖项。通常，应仅列出规则目标。（虽然某些规则允许文件直接列在 deps 中，但应尽可能避免这种情况。）

特定于语言的规则通常将列出的目标限制为具有特定 provider 的目标。

对于目标使用 deps 依赖于另一个目标而言，其具体含义因规则类型而异，有关规则的文档更加详细地介绍。对于处理源代码的规则，deps 通常会指定 srcs 中的代码使用的代码依赖项。

大多数情况下，deps 依赖项用于允许一个模块使用在以同一编程语言编写并单独编译的另一个模块中定义的符号。在许多情况下，也允许使用跨语言依赖项：例如，java_library 目标可以依赖于 cc_library 目标中的 C++ 代码，具体方法是在 deps 属性中列出后者。如需了解详情，请参阅依赖项的定义。

字符串列表；不可配置；默认值为 ["none"]

要用于此特定目标的许可类型字符串列表。 这是 Bazel 不再使用的已弃用许可 API 的一部分。请勿使用。

标签列表；默认值为 []

此规则处理或包含的文件。通常直接列出文件，但也可以列出规则目标（如 filegroup 或 genrule）以包含其默认输出。

语言特定的规则通常要求列出的文件具有特定的文件扩展名。

标签列表；不可配置；默认值为 []

除了默认支持的环境外，您还可构建此目标的环境列表。

这是 Bazel 约束系统的一部分，可让用户声明哪些目标可以相互依赖，哪些目标不能相互依赖。例如，可在外部部署的二进制文件不应依赖于包含公司密钥代码的库。如需了解详情，请参阅 ConstraintSemantics。

字符串；不可配置；默认值为 None

与此目标相关联的说明性警告消息。 通常，此字段用于通知用户目标已作废、被其他规则取代、对软件包专用，或可能因某种原因而被视为有害。建议您附上一些参考信息（例如网页、bug 编号或示例迁移 CL），以便用户轻松了解需要执行哪些更改才能避免收到此类消息。如果有可用作替换项的新目标，最好只迁移旧目标的所有用户。

此属性对构建方式没有影响，但可能会影响构建工具的诊断输出。当具有 deprecation 属性的规则被另一个软件包中的目标依赖于时，构建工具会发出警告。

软件包内依赖项不受此警告的约束，因此，举例来说，在构建已弃用的规则的测试时就不会遇到警告。

如果已弃用的目标依赖于另一个已弃用的目标，系统不会发出警告消息。

一旦用户停止使用该目标，您就可以移除该目标。

字符串列表；不可配置；默认值为 []

要用于此特定目标的分发方法字符串列表。 这是 Bazel 不再使用的已弃用许可 API 的一部分。请勿使用。

标签列表；不可配置；默认值为 []

此目标的执行平台中必须存在的 constraint_values 列表。除了规则类型已设置的任何限制条件之外，限制条件用于限制可用执行平台的列表。如需了解详情，请参阅工具链解析的说明。

字符串字典；默认值为 {}

将添加到为此目标选择的平台的 exec_properties 中的字符串字典。请参阅 platform 规则的 exec_properties。

如果平台级属性和目标级属性中均存在某个键，系统将从定位条件中获取该值。

feature 字符串列表；默认值为 []

功能是指可在目标上启用或停用的字符串标记。特征的含义取决于规则本身。

此 features 属性与 软件包级 features 属性结合使用。例如，如果在软件包级别启用了功能 ["a", "b"]，并且目标的 features 属性包含 ["-a", "c"]，则为该规则启用的功能将为“b”和“c”。 查看示例。

标签列表；不可配置；默认值为 []

此目标可以针对哪些环境（而非支持的默认环境）进行构建。

这是 Bazel 约束系统的一部分。如需了解详情，请参阅 compatible_with。

字符串列表；不可配置；默认为 []

标记可用于任何规则。测试中的标记和 test_suite 规则有助于对测试进行分类。非测试目标上的标记用于控制 genrule 和 Starlark 操作的沙盒化执行，以及人工和/或外部工具解析。

如果 Bazel 在任何测试或 genrule 目标的 tags 属性中发现以下关键字，或者在任何 Starlark 操作的 execution_requirements 键中发现以下关键字，会修改其沙盒代码的行为。

• no-sandbox 关键字会导致操作或测试永远不会沙盒化；它仍然可以缓存或远程运行 - 使用 no-cache 或 no-remote 来防止出现其中一种或两种情况。
• no-cache 关键字会导致操作或测试永远无法缓存（本地或远程）。注意：就此标记而言，磁盘缓存被视为本地缓存，而 HTTP 和 gRPC 缓存被视为远程缓存。其他缓存（例如 Skyframe 或永久性操作缓存）不受影响。
• no-remote-cache 关键字会导致操作或测试永远无法远程缓存（但可以缓存在本地，也可以远程执行）。 注意：就此标记而言，磁盘缓存被视为本地缓存，而 HTTP 和 gRPC 缓存被视为远程缓存。其他缓存（例如 Skyframe 或永久性操作缓存）不受影响。 如果同时使用本地磁盘缓存和远程缓存（组合缓存），则系统会将其视为远程缓存并完全停用，除非设置了 --incompatible_remote_results_ignore_disk，在这种情况下将使用本地组件。
• no-remote-exec 关键字会导致操作或测试永远不会被远程执行（但可能会被远程缓存）。
• no-remote 关键字可防止操作或测试被远程执行或远程缓存。这相当于同时使用 no-remote-cache 和 no-remote-exec。
• no-remote-cache-upload 关键字会停用衍生品的远程缓存的上传部分。不会停用远程执行。
• local 关键字可阻止操作或测试在沙盒内远程缓存、远程执行或运行。对于 genrule 和测试，使用 local = True 属性标记规则具有相同的效果。
• requires-network 关键字允许从沙盒内部访问外部网络。只有在启用了沙盒的情况下，此标记才有效。
• block-network 关键字可阻止从沙盒内部访问外部网络。在这种情况下，仅允许与 localhost 通信。只有在启用了沙盒的情况下，此标记才会生效。
• requires-fakeroot 以 uid 和 gid 0（即根用户）的形式运行测试或操作。只有 Linux 支持此功能。此标记优先于 --sandbox_fake_username 命令行选项。

测试上的标记通常用于注释测试在调试和发布流程中的角色。通常，标记最适合缺少任何运行时注解功能的 C++ 和 Python 测试。通过使用标记和大小元素，您可以根据代码库签入政策灵活地组合测试套件。

如果 Bazel 在测试规则的 tags 属性中发现以下关键字，会修改测试运行行为：

• exclusive 会强制以“独占”模式运行测试，以确保没有其他测试同时运行。此类测试将在所有构建活动和非独占测试完成后依次执行。此类测试的远程执行已停用，因为 Bazel 无法控制远程机器上运行的内容。
• 如果测试在本地执行，exclusive-if-local 会强制以“独占”模式运行，但如果远程执行，则会并行运行测试。
• manual 关键字会将目标从目标模式通配符（...、:*、:all 等）和 test_suite 规则的扩展中排除，这些规则在计算要针对 build、test 和 coverage 命令构建/运行的顶级目标集时，不会明确列出测试。而不会影响其他上下文（包括 query 命令）中的目标通配符或测试套件扩展。请注意，manual 并不意味着目标不应由连续构建/测试系统自动构建/运行。例如，可能需要从 bazel test ... 中排除目标，因为它需要特定的 Bazel 标志，但仍包含在正确配置的提交前或连续测试运行中。
• external 关键字会强制无条件执行测试（无论 --cache_test_results 值如何）。

标签列表；默认值为 []

目标平台中必须存在的 constraint_value 列表，系统才会将此目标视为兼容。这是对规则类型已设置的任何限制条件的补充。如果目标平台不满足列出的所有限制条件，则目标会被视为不兼容incompatible。当目标模式展开（例如 //...、:all）时，系统将跳过不兼容的目标进行构建和测试。如果在命令行中明确指定，则不兼容的目标会导致 Bazel 输出错误，并导致构建或测试失败。

传递依赖于不兼容目标的目标本身会被视为不兼容。构建和测试也会跳过这些测试。

空列表（这是默认值）表示目标与所有平台兼容。

工作区规则以外的所有规则均支持此属性。对于部分规则，此属性无效。例如，为 cc_toolchain 指定 target_compatible_with 没有用处。

如需详细了解不兼容的目标跳过，请参阅平台页面。

布尔值；不可配置；默认值为 False（测试套件目标和测试套件目标除外）

如果为 True，则只有 testonly 目标（例如测试）可以依赖于此目标。

同样，不为 testonly 的规则不得依赖于任何为 testonly 的规则。

默认情况下，测试（*_test 规则）和测试套件（test_suite 规则）为 testonly。

此属性旨在表示目标不应包含在已发布到生产环境的二进制文件中。

由于 testonly 在构建时（而不是运行时）强制执行，并且通过依赖项树以病毒方式传播，因此应谨慎应用测试。例如，对单元测试有用的存根和虚假对象可能对涉及将发布到生产环境的相同二进制文件的集成测试也很有用，因此可能不应该标记为 testonly。反过来，有些规则甚至很危险（可能是由于它们会无条件地替换正常行为），因此请务必将其标记为 testonly。

标签列表；不可配置；默认值为 []

此目标可以访问其 Make 变量的一组目标。这些目标可以是提供 TemplateVariableInfo 的规则实例，也可以是内置到 Bazel 中的工具链类型特殊目标的特殊目标。其中包括：

• @bazel_tools//tools/cpp:current_cc_toolchain
• @bazel_tools//tools/jdk:current_java_runtime

请注意，这与工具链解析的概念不同，工具链解析是基于平台的配置的规则实现所使用的概念。您无法使用此属性来确定目标将使用哪个特定的 cc_toolchain 或 java_toolchain。

标签列表；不可配置；如果指定，则默认为 package 中的 default_visibility，否则为 "//visibility:private"

目标上的 visibility 属性用于控制目标是否可以在其他软件包中使用。请参阅关于可见性的文档。

字符串列表；可以使用 $(location) 和 "Make variable" 替换，以及 Bourne shell 标记化；默认值为 []

使用 bazel test 执行 Bazel 时向其传递的目标的命令行参数。

这些参数会在 bazel test 命令行中指定的任何 --test_arg 值之前传递。

字符串字典；值可以替换 $(location) 和 "Make variable"；默认值为 {}

指定由 bazel test 执行测试时要设置的其他环境变量。

此属性仅适用于原生规则，如 cc_test、py_test 和 sh_test。但不适用于 Starlark 定义的测试规则。对于您自己的 Starlark 规则，您可以添加一个“env”属性，并用它来填充 TestEnvironment 提供方。

字符串列表；默认值为 []

指定在 bazel test 执行测试时从外部环境继承的其他环境变量。

此属性仅适用于原生规则，如 cc_test、py_test 和 sh_test。但不适用于 Starlark 定义的测试规则。

字符串 "enormous"、"large"、"medium" 或 "small"；不可配置；默认值为 "medium"

指定测试目标的“承重性”：测试需要运行的时间/资源。

单元测试被视为“小型”，集成测试“中”，端到端测试被视为“大型”或“超大”。Bazel 会根据大小来确定默认超时，您可以使用 timeout 属性来替换默认超时时间。超时针对的是 BUILD 目标中的所有测试，而不是针对各个测试。在本地运行测试时，size 还会用于安排目的：Bazel 会尝试遵循 --local_{ram,cpu}_resources，不会因同时运行大量密集型测试而导致本地机器过载。

测试大小对应于以下默认超时时间和假定峰值本地资源使用量：

生成测试时，环境变量 TEST_SIZE 将设置为此属性的值。

字符串 "short"、"moderate"、"long" 或 "eternal"；不可配置；默认值派生自测试的 size 属性

在返回之前，测试预期运行多长时间。

虽然测试的大小属性用于控制资源估算，但测试的超时可以单独设置。如果未明确指定，则超时取决于测试的大小。测试超时可以使用 --test_timeout 标志替换，例如，在某些已知慢的条件下运行。测试超时值对应于以下时间段：

对于除上述情况之外的时间，可以使用 --test_timeout bazel 标志替换测试超时，例如，在已知慢的条件下手动运行。--test_timeout 值以秒为单位。例如，--test_timeout=120 会将测试超时设置为两分钟。

生成测试时，环境变量 TEST_TIMEOUT 将设置为测试超时（以秒为单位）。

布尔值；不可配置；默认值为 False

将测试标记为不稳定。

如果设置了此字段，则最多执行 3 次测试，仅当每次失败时才会将测试标记为失败。默认情况下，此属性设置为 False，并且测试仅执行一次。请注意，通常不建议使用此属性，如果测试的断言得到支持，测试应能可靠地通过。

小于或等于 50 的非负整数；默认值为 -1

指定用于运行测试的并行分片数量。

如果设置了此值，则此值将覆盖用于确定用于运行测试的并行分片数量的任何启发式方法。请注意，对于某些测试规则，首先可能需要使用此参数才能启用分片。另请参阅 --test_sharding_strategy：

如果启用了测试分片，则在生成测试时，环境变量 TEST_TOTAL_SHARDS 将设置为此值。

分片要求测试运行程序支持测试分片协议。否则，它很可能在每个分片中运行每个测试，但这不是您想要的结果。

如需详细了解分片，请参阅《测试百科全书》中的测试分片。

布尔值；不可配置；默认值为 False

强制在本地运行，而不使用沙盒。

将此属性设置为 True 相当于以标记 (tags=["local"]) 的形式提供“local”。

字符串列表；可以使用 $(location) 和“创建变量”替换项，以及 Bourne shell 标记化；不可配置；默认值为 []

Bazel 会在由 run 命令执行或作为测试执行时传递给目标的命令行参数。这些参数会在 bazel run 或 bazel test 命令行中指定的参数之前传递。

注意：在 Bazel 之外运行目标（例如，通过在 bazel-bin/ 中手动执行二进制文件）时，系统不会传递参数。

字符串字典；值可以替换为 $(location) 和 "Make variable"；默认值为 {}

指定由 bazel run 执行目标时要设置的其他环境变量。

此属性仅适用于原生规则，如 cc_binary、py_binary 和 sh_binary。但不适用于 Starlark 定义的可执行规则。

注意：在 Bazel 之外运行目标（例如，通过在 bazel-bin/ 中手动执行二进制文件）时，系统不会设置环境变量。

字符串列表；默认值为 []

此二进制文件生成的输出文件的许可。 这是 Bazel 不再使用的已弃用许可 API 的一部分。请勿使用。