如何向GitHub推送带tag的内容以触发对应Action

本地打标签操作 #

• 首先确保你本地的代码已经全部提交完成，工作区无未提交的改动，可执行git status确认状态
• 如果你只需要打轻量标签（仅作为版本标记，无额外附属信息），执行命令：
  git tag <自定义标签名>
  示例：git tag v1.0.0
• 如果你需要打附注标签（包含打标签人、时间、备注信息，更推荐用于正式版本发布场景），执行命令：
  git tag -a <自定义标签名> -m "标签备注内容"
  示例：git tag -a v1.0.0 -m "正式发布1.0.0版本，修复支付接口兼容性问题"

推送标签到GitHub远程仓库 #

注意常规的git push操作默认不会同步本地标签到远程仓库，需要执行专门的推送命令：

• 推送单个指定标签到远程：
  git push origin <你打的标签名>
  示例：git push origin v1.0.0
• 一次性推送本地所有未同步到远程的标签：
  git push origin --tags

提示：如果你的GitHub Action配置了特定格式的tag匹配规则（比如要求标签必须是v开头的语义化版本），需要确保你打的标签名符合规则，否则不会触发工作流。

常见问题处理 #

• 打错本地标签需要删除：执行git tag -d <错误的标签名>
• 已经推送到远程的标签需要删除：执行git push origin --delete <错误的标签名>

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