常见定义

标签列表；默认值为 []

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

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

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

标签列表；默认值为 []

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

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

使用 deps 时，一个目标依赖于另一个目标的确切语义因规则类型而异，具体请参阅特定于规则的文档。对于处理源代码的规则，deps 通常会指定 srcs 中的代码所使用的代码依赖项。

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

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

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

标签列表；默认值为 []

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

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

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

此目标可以为其构建的列表，以及默认支持的环境。

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

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

与此目标相关的说明性警告消息。 通常，此属性用于通知用户目标已过时、已被其他规则取代、仅供软件包使用，或者可能因某种原因被视为有害。建议您添加一些参考资料（例如网页、bug 编号或迁移 CL 示例），以便用户轻松了解需要做出哪些更改才能避免此消息。 如果有可用作替代目标的新目标，最好只迁移旧目标的所有用户。

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

软件包内依赖项不受此警告的约束，因此，例如，构建已废弃规则的测试时不会遇到警告。

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

用户停止使用该目标后，您就可以将其移除。

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

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

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

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

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

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

如果平台级和目标级属性中都存在某个键，系统会从目标中获取值。

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

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

此 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 关键字会停用 spawn 的远程缓存上传部分。 它不会停用远程执行。
• local 关键字可阻止在沙盒内远程缓存、远程执行或运行操作或测试。 对于 genrule 和测试，使用 local = True 属性标记规则具有相同的效果。
• requires-network 关键字允许从沙盒内访问外部网络。只有在启用沙盒化后，此标记才会生效。
• block-network 关键字会阻止从沙盒内部访问外部网络。在这种情况下，只允许与 localhost 通信。此标记仅在启用了沙盒的情况下有效。
• requires-fakeroot 以 uid 和 gid 0（即根用户）身份运行测试或操作。只有 Linux 支持此功能。此标记的优先级高于 --sandbox_fake_username 命令行选项。

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

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

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

标签列表；默认值为 []

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

对不兼容的目标进行传递依赖的目标本身也被视为不兼容。在构建和测试时，系统也会跳过这些文件。

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

除了 Workspace 规则之外，所有其他规则都支持此属性。对于某些规则，此属性不会产生任何影响。例如，为 cc_toolchain 指定 target_compatible_with 没有用处。

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

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

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

等效地，非 testonly 规则不得依赖于任何 testonly 规则。

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

此属性旨在表示目标不应包含在已发布为正式版的二进制文件中。

由于 testonly 是在构建时（而非运行时）强制执行的，并且会通过依赖项树进行病毒式传播，因此应谨慎应用。例如，对单元测试有用的桩和虚构对象可能也对涉及要发布到生产环境的相同二进制文件的集成测试有用，因此可能不应标记为仅用于测试。相反，如果规则连链接都很危险（可能是因为它们会无条件替换正常行为），则绝对应将其标记为仅用于测试。

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

此目标允许访问的 Make 变量所在的目标集。这些目标是提供 TemplateVariableInfo 的规则的实例，或者是针对内置于 Bazel 中的工具链类型的特殊目标。其中包括：

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

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

标签列表；不可配置；默认是软件包中的 default_visibility（如果已指定），否则为 "//visibility:private"

目标上的 visibility 属性用于控制目标能否在其他软件包中使用。如需了解可见性，请参阅文档。

字符串列表；会接受 $(location) 和 “Make 变量”替换，以及 Bourne shell 令牌化；默认为 []

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

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

字符串字典；值会替换为 $(location) 和 “设备变量”；默认值为 {}

指定在 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

将测试标记为不稳定。

如果设置，则最多执行三次测试，仅当每次都失败时才将其标记为失败。默认情况下，此属性设置为 False，且仅执行一次测试。请注意，通常不建议使用此属性 - 当测试的断言成立时，测试应可靠地通过。

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

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

如果设置，此值将替换用于确定用于运行测试的并行分片数量的任何启发词语。请注意，对于某些测试规则，可能需要从一开始就启用分片。另请参阅 --test_sharding_strategy：

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

分片需要测试运行程序支持测试分片协议。如果没有，则很可能会在每个分片中运行每项测试，这不是您想要的结果。

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

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

强制在本地运行测试，而不进行沙盒化。

将此属性设置为 True 等同于将“local”作为标记 (tags=["local"]) 提供。

字符串列表；会受到 $(location) 和 “Make 变量”替换以及 Bourne shell 令牌化的影响；不可配置；默认为 []

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

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

字符串字典；值会替换为 $(location) 和 “设备变量”；默认值为 {}

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

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

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

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

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