Bazel query 怎么按规则类型筛选目标

在大型 Bazel 仓库里，直接执行 bazel query //app/... 往往会得到混合的规则、源文件和生成文件。需要只看测试规则、C++ 规则或某一类构建目标时，最稳妥的写法是用 kind(pattern, input) 包住原来的目标集合，再用 --output=label_kind 把结果类型打印出来。

官方地址：https://bazel.build/

先把查询范围写清楚

kind 不会替你扩大搜索范围。只查一个包时可以使用 //app:*，递归查看目录下的目标则使用 //app/...。范围过大不仅输出难读，还会让无关 BUILD 文件参与加载。

#!/usr/bin/env bash
# 先列出 app 包中的全部目标，确认后续过滤的输入集合
bazel query '//app:*' --output=label_kind

# 递归查看 app 目录下的规则与文件目标
bazel query '//app/...' --output=label_kind

如果只想分析某个二进制的传递依赖，可以把输入换成 deps(//app:server)。这个变化很关键：前者回答“目录里有哪些目标”，后者回答“构建该目标需要哪些依赖目标”。

用 kind 按规则类型筛选

最小写法如下，kind 的第一个参数是正则模式，第二个参数是待筛选集合：

#!/usr/bin/env bash
# 只保留 app 包中的测试规则，test 会匹配 *_test rule 与 test_suite
bazel query 'kind(".*_test rule", //app:*)' --output=label_kind

# 递归筛选 C++ 规则，cc_.* 覆盖 cc_library、cc_binary 等名称
bazel query 'kind("cc_.* rule", //app/...)' --output=label_kind

模式通常要加引号。像 source file、.*_test 这样的表达式包含空格或正则字符，不加引号时可能先被 shell 或 Bazel 查询解析器拆开。规则类型的完整文本还带有 rule 后缀，所以只写 cc_library 可能匹配不到预期结果。

用 label_kind 核对筛选结果

排查时建议固定加上 --output=label_kind。它会在标签前显示目标类型，能区分同名的规则、源文件和生成文件：

#!/usr/bin/env bash
# 同时显示类型和标签，确认结果确实是规则而不是同名文件
bazel query 'kind(".*_test rule", deps(//app:server))' \
  --output=label_kind

# 只看规则声明位置，便于回到 BUILD 文件核对
bazel query 'kind("cc_.* rule", //app/...)' \
  --output=location

把 kind 和依赖、名称过滤组合起来

真实排查通常需要两层过滤。例如，只想找服务依赖闭包中名称带 proto 的生成规则，可以先按类型取集合，再按标签名筛选：

#!/usr/bin/env bash
# 先取 server 的传递依赖，再按规则类型缩小集合
bazel query 'kind("genrule rule", deps(//app:server))' \
  --output=label

# 在依赖闭包中只保留标签包含 proto 的规则
bazel query 'filter("proto", kind(".* rule", deps(//app:server)))' \
  --output=label_kind

kind 判断“它是什么类型”，filter 判断“它的标签名是否包含某个模式”，两者职责不同。不要用标签名猜测规则类型，也不要把 filter 的结果当成属性过滤；如果要按 tags、srcs 等属性筛选，应使用 attr。

空结果和 query 层级的处理方法

返回空集合时先检查三件事：输入标签是否存在，规则类型模式是否写成了完整的类型文本，以及查询范围是否包含目标。可以先去掉 kind 看原始集合，再加回过滤条件。

#!/usr/bin/env bash
# 先确认依赖集合非空，再逐步加入类型条件
bazel query 'deps(//app:server)' --output=label
bazel query 'kind("cc_.* rule", deps(//app:server))' --output=label_kind

# BUILD 文件存在局部错误时，允许 query 尽量继续返回结果
bazel query 'kind(".*_test rule", //app/...)' --keep_going \
  --output=label_kind

还要区分分析层级：传统 bazel query 面向加载阶段的目标图，不解析具体配置下的 select 结果；需要配置感知时看 cquery，需要动作、制品和实际命令时看 aquery。这不是把 kind 写错，而是查询目标变了。

常见问题

为什么 kind("test", //app:*) 能查到测试？

因为测试目标的类型文本可以被 test 模式匹配；如果需要更宽或更明确的匹配，使用 .*_test rule 并配合 label_kind 核对。

为什么只写 cc_library 没有结果？

kind 比较的是目标 kind 文本，规则结果通常显示为 cc_library rule，因此用 cc_library.* 或 cc_library rule 更稳妥。

kind 能按 BUILD 属性筛选吗？

不能。kind 只看类型，按属性值应改用 attr(name, pattern, input)，然后再结合目标范围。

query 输出顺序能代表构建执行顺序吗？

不能直接这样理解。输出格式和排序选项影响展示顺序；文章中的类型筛选只负责得到目标集合，不等价于动作执行计划。

记住一条组合规则即可：先用目标模式或 deps() 定义集合，再用 kind() 定义类型，最后按需要选择 label_kind、location 或 filter() 做核对和收敛。