如何使用Buf CLI针对单个文件检查兼容性变更？

当然可以用buf breaking针对单个proto文件做兼容性检测，官方文档虽然主要侧重子目录场景，但单个文件的用法是完全支持的。

具体操作的核心是通过--against参数指定基线版本的单个文件，再将目标单个文件作为命令的输入路径即可，给两个常见场景的示例：

• 对比本地两个不同路径下的同一份proto文件：

  buf breaking --against ./baseline/foo.proto ./current/foo.proto
  

• 对比当前文件与Git历史版本中的同一份文件（比如上一次提交的版本）：

  buf breaking --against git://.#branch=main,ref=HEAD~1:./foo.proto ./foo.proto
  

需要注意的是，如果该proto文件依赖其他文件，要确保Buf能通过buf.yaml配置找到这些依赖路径，否则可能因依赖缺失报错。

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