GitHub Actions带[skip ci]提交导致标签发布不触发工作流如何解决

GitHub Actions的[skip ci]/[ci skip]跳过规则是绑定提交SHA全局生效的：只要Tag指向的提交备注中包含跳过指令，无论触发事件是分支推送还是标签推送，对应工作流都会被拦截跳过，官方没有提供“跳过规则仅对分支生效、排除标签事件”的原生配置。

按优先级从高到低可选以下方案：

方案1：移除[skip ci]，用工作流条件判断避免循环触发（推荐） #

你加[skip ci]的核心目的是防止自动提交再次触发CI造成死循环，这个需求完全可以通过工作流的条件判断实现，从根源上消除跳过指令对Tag事件的影响。

修改后的工作流配置参考：

on:
  push:
    branches:
      - '**' # 匹配所有分支推送
    tags:
      - 'v*' # 按你的版本命名规则配置标签匹配规则，例如所有v开头的版本标签
jobs:
  ci:
    runs-on: ubuntu-latest
    # 过滤掉CI自动生成的提交，避免循环触发
    if: ${{ !contains(github.event.head_commit.message, 'build: Image tag updated') }}
    steps:
      - name: build and push image 
      - name: update image tag
        
      - name: Commit changes
        run: |
          git config --global user.name 'abc'
          git config --global user.email 'xyz@users.noreply.github.com'
          git remote set-url origin https://${{ secrets.PERSONAL_ACCESS_TOKEN }}@github.com/${{ github.repository }}
          # 提交备注移除[skip ci]标记
          git commit -am "build: Image tag updated"
          git push

你也可以根据自己的习惯，用github.actor判断提交者是否为CI专用账号，逻辑等价。

方案2：打版本标签前新增空提交 #

如果不想调整现有CI逻辑，可以在发布版本打标签前，先创建一个不带任何跳过指令的空提交，再将标签打在这个新提交上即可：

# 创建发布用空提交
git commit --allow-empty -m "chore: release 版本号"
# 给新提交打标签
git tag 你的版本标签名
# 同时推送提交和标签
git push origin 对应分支名 --tags

注意不要把标签直接打在之前带[skip ci]的自动提交上，否则依然会被拦截。

方案3：拆分工作流 #

将分支构建和版本发布拆为两个独立的工作流文件：

• 分支构建工作流：保留现有[skip ci]逻辑，仅配置分支触发规则，不监听标签推送事件
• 版本发布工作流：单独监听标签推送事件，配合方案2的打标签规范，避免标签指向带跳过指令的提交即可。

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