Buf项目关于`buf push --tag`命令废弃的清晰指引

在Buf项目的版本迭代过程中，buf push --tag命令已被标记为废弃状态。这个命令原本用于在推送模块时同时打上标签，但新的设计理念更倾向于使用--label参数来实现更灵活的标记功能。

命令废弃背景

buf push --tag命令的设计存在一些局限性，它实际上执行了两个操作：一是将模块推送到默认标签(default label)，二是为推送的内容打上指定的标签。这种隐式的双重操作可能导致用户对其行为理解不够清晰。

替代方案详解

现在官方推荐使用--label参数来替代--tag，但需要注意这不是简单的参数名称替换。正确的替代方式应该是：

buf push --label <default-label> --label <custom-label>

这种显式的参数传递方式让操作意图更加明确，用户可以清楚地看到推送操作会应用到哪些标签上。

补充操作建议

对于需要为已有提交添加标签的场景，Buf提供了专门的命令：

buf registry commit add-label <commit> <label>

这个命令允许用户在不重新推送的情况下，为历史提交添加新的标签，提供了更大的灵活性。

最佳实践

1. 明确区分推送操作和标签管理：推送时使用--label参数，后续管理使用专门的标签管理命令
2. 保持标签命名一致性：建议建立团队内部的标签命名规范
3. 逐步迁移：现有脚本中可以先用新参数替代，再逐步优化为更合理的标签管理方式

通过这种改进，Buf为用户提供了更清晰、更灵活的模块发布和版本管理方式，虽然短期内需要一些适应，但长期来看将提高工作流的可维护性。