如何在GitHub中自动保留指定数量的最新tag？

方案1：手动批量清理旧tag #

适合一次性清理现有积压的旧tag，操作步骤如下：

• 先拉取远程所有最新tag到本地：

git fetch origin --tags

• 确认筛选逻辑：使用--sort=-version:refname参数可以让tag按版本号从高到低倒序排列，最新版本排在最前面，你可以按需增加grep过滤规则筛选特定规则的tag，比如只处理v开头的正式版本tag：

# 列出所有v开头的tag，最新的在前
git tag -l --sort=-version:refname | grep "^v"

• 批量删除超出保留数量的tag，以保留最新5个tag为例：

# 先执行该命令确认要删除的tag列表，避免误删
git tag -l --sort=-version:refname | grep "^v" | tail -n +6

# 批量删除本地旧tag
git tag -l --sort=-version:refname | grep "^v" | tail -n +6 | xargs git tag -d

# 批量删除远程旧tag
git tag -l --sort=-version:refname | grep "^v" | tail -n +6 | xargs -I {} git push origin :refs/tags/{}

注意：操作前一定要先执行筛选列表命令确认要删除的内容，避免误删重要版本tag

方案2：配置GitHub Actions自动保留最新N个tag #

配置后无需手动操作，每次推送新tag时会自动清理旧tag，始终保留指定数量的最新tag：

1. 在仓库根目录创建.github/workflows/clean-old-tags.yml文件
2. 写入如下配置，可自行修改KEEP_NUM参数调整保留的tag数量，示例为保留5个：

name: 清理旧Tag
on:
  push:
    tags:
      - 'v*' # 可根据你的tag命名规则调整触发条件

jobs:
  clean-tags:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取完整历史和所有tag
      - name: 配置Git身份
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
      - name: 清理超出保留数量的旧tag
        run: |
          # 定义保留的最新tag数量
          KEEP_NUM=5
          # 筛选出需要删除的旧tag
          DELETE_TAGS=$(git tag -l --sort=-version:refname "v*" | tail -n +$((KEEP_NUM+1)))
          if [ -n "$DELETE_TAGS" ]; then
            echo "待删除旧tag列表：$DELETE_TAGS"
            # 删除本地tag
            echo $DELETE_TAGS | xargs git tag -d
            # 删除远程tag
            echo $DELETE_TAGS | xargs -I {} git push origin :refs/tags/{}
          else
            echo "当前tag数量未超过保留上限，无需清理"
          fi

3. 将该配置文件提交到仓库主分支即可生效。

临时快速查找特定tag的方法 #

如果你不想删除旧tag，仅需要解决查找繁琐的问题，可以用以下方法：

• 本地查找：直接使用你已掌握的命令加关键词过滤即可快速定位，比如查找包含v2.1的tag：

git tag -l --sort=version:refname | grep "v2.1"

• GitHub网页端查找：进入仓库的Tags页面，直接在页面顶部的搜索框输入关键词，系统会自动过滤匹配的tag，无需手动翻页。

注意：如果你的tag包含多种类型（比如正式版、测试版），可以在筛选规则里增加区分条件，避免不同类型的tag混在一起排序删除。

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