CircleCI部署GitHub Pages：配置分支忽略仍触发CI的问题求助

我之前也踩过这个坑！CircleCI 2.0的分支过滤逻辑和旧版本不一样，你直接把branches.ignore放在jobs.build下面是不生效的，这就是为什么gh-pages分支提交还是会触发CI，甚至出现“No tests”错误的核心原因。

问题根源 #

CircleCI 2.0废弃了1.0版本中直接在job层级配置分支规则的方式，分支的触发/忽略必须通过workflow的filters来定义。如果你的配置里没有显式声明workflows，CircleCI会自动生成一个默认workflow，这个默认流程不会读取job里的分支配置，所以gh-pages分支的提交依然会触发构建；而gh-pages分支通常只有静态部署文件，没有测试用例，自然就会报“No tests”的错误。

正确的配置方式 #

你需要修改config.yml，添加workflow并在其中配置分支过滤规则，示例如下：

version: 2
jobs:
  build:
    # 保留你原有的build任务步骤，比如checkout、安装依赖、编译、部署到gh-pages等
    steps:
      - checkout
      # 你的其他构建/部署步骤...

workflows:
  version: 2
  build-and-deploy:
    jobs:
      - build:
          filters:
            branches:
              ignore: gh-pages  # 明确忽略gh-pages分支触发build任务

额外优化：从源头避免触发CI #

如果你的build任务里包含了自动提交到gh-pages分支的逻辑，建议在提交时加上[skip ci]或[ci skip]标记，这样GitHub会直接跳过触发CI的步骤，从根源上避免循环触发的问题。比如你的git提交命令可以改成：

git commit -m "Deploy static files to gh-pages [skip ci]"

这样即使gh-pages分支产生新提交，也不会触发CircleCI的构建，彻底解决这个问题。

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