如何获取Bazel目标签名并生成带签名的依赖图及构建校验问题

1. 无需重建判断目标是否需要重新构建 #

可以用bazel build --nobuild命令，它会完成所有构建前的分析（依赖解析、变更检测），输出哪些目标需要被构建，且不会实际执行编译/链接动作。

• 示例：bazel build --nobuild //path/to:target，输出中会标记出需要重新构建的目标（无缓存命中的情况）
• 若要获取详细的重建原因，加上--explain=rebuild_reasons.txt参数，生成的文件会列出每个目标触发重建的具体因素（比如源文件修改、依赖变更等）

另外，可通过bazel cquery结合Starlark脚本自定义筛选需要重建的目标：

# 示例脚本 needs_rebuild.bzl
def format_target(target):
    return "%s: %s" % (target.label, "NEEDS REBUILD" if target.is_outdated else "UP TO DATE")

def _output_function(targets):
    for target in targets:
        print(format_target(target))

执行命令：bazel cquery //path/to:target --output=starlark --starlark:file=needs_rebuild.bzl

2. 获取目标签名用于版本对比 #

Bazel的动作签名（决定构建动作是否需要重新执行的核心标识）可通过以下方式获取：

• 使用bazel aquery查询动作摘要，提取action_digest字段：

  bazel aquery //path/to:target --output=textproto | grep -A2 action_digest
  

  这个action_digest是目标构建动作的唯一哈希，只要构建输入（源文件、依赖、规则定义等）不变，哈希就不会改变，适合跨Git提交对比。
• 若需要目标输出文件的哈希（比如最终二进制/库的哈希），直接计算输出文件的SHA值即可：

  sha256sum $(bazel info bazel-bin)/path/to/target_binary
  

• 对于未构建的目标，结合--nobuild和--output_groups=signatures，Bazel会生成包含签名的临时文件：

  bazel build --nobuild --output_groups=signatures //path/to:target
  

  签名文件路径会在输出中给出，可直接读取对比。

3. 生成带签名的依赖图 #

由于bazel query不涉及构建状态，无法直接获取签名，可通过以下组合方式实现：

1. 先用bazel cquery获取目标的完整依赖链：

   bazel cquery 'deps(//path/to:target)' --output=label > deps_list.txt
   

2. 用bazel aquery结合自定义Starlark脚本，将目标标签、签名和依赖关系输出为Graphviz格式：

   # 示例脚本 generate_sig_graph.bzl
   def _output_function(actions):
       print("digraph bazel_deps {")
       seen = set()
       for action in actions:
           target_label = action.target_labels[0]
           sig = action.action_digest.hash
           if target_label not in seen:
               print(f'  "{target_label}" [label="{target_label}\\n{sig[:8]}"];')
               seen.add(target_label)
           for dep in action.input_deps:
               dep_label = dep.label
               if dep_label not in seen:
                   dep_sig = dep.action_digest.hash if hasattr(dep, "action_digest") else "N/A"
                   print(f'  "{dep_label}" [label="{dep_label}\\n{dep_sig[:8]}"];')
                   seen.add(dep_label)
               print(f'  "{target_label}" -> "{dep_label}";')
       print("}")
   

   执行命令生成Graphviz文件：

   bazel aquery 'deps(//path/to:target)' --output=starlark --starlark:file=generate_sig_graph.bzl > deps_graph.dot
   

3. 用Graphviz工具生成可视化图：

   dot -Tpng deps_graph.dot -o deps_graph.png
   

跨版本对比时，只需分别生成两个Git提交的.dot文件，用diff工具对比即可找出受影响的节点、新增或移除的边。

内容的提问来源于stack exchange，提问作者Gregory Wright