CircleCI 2.0 Workflow中requires选项无法正常工作的问题

嘿，我看了你贴的CircleCI配置，问题大概率出在YAML的缩进规范上——YAML对层级缩进的要求非常严格，哪怕一个空格不对都会触发配置错误。另外你提供的示例里only: master部分的写法也有点小问题，我帮你修正并详细解释下：

修正后的完整配置示例 #

version: 2
jobs:
  build:
    docker:
      - image: circleci/node:18  # 替换成你项目实际需要的运行镜像
    steps:
      - checkout
      - run: echo "执行build编译步骤..."
      # 这里添加你实际的构建命令，比如npm install、打包编译等
  test:
    docker:
      - image: circleci/node:18
    steps:
      - checkout
      - run: echo "执行test测试步骤..."
      # 添加你的测试命令，比如npm test、单元测试/集成测试脚本等
  deploy:
    docker:
      - image: circleci/node:18
    steps:
      - checkout
      - run: echo "执行deploy部署步骤..."
      # 添加你的部署命令，比如部署到云平台、服务器等操作
workflows:
  version: 2
  myapp_ci:
    jobs:
      - build
      - test:
          requires:
            - build  # test任务必须在build执行成功后才会触发
      - deploy:
          requires:
            - test  # deploy任务必须在test执行成功后才会触发
          filters:
            branches:
              only: master  # 仅在master分支触发部署流程

关键错误点说明 #

1. 缩进一致性问题：确保requires和filters是同级配置，都缩进在deploy:下方（建议统一用2个空格缩进，绝对不要混合制表符和空格，CircleCI对这个校验特别严格）。
2. Job定义完整性：你的示例里用...占位，实际配置中每个job必须包含完整的运行环境（比如docker或machine）和steps执行步骤，否则会触发配置校验失败。
3. 分支过滤器格式：filters.branches.only的层级缩进要正确，only后面可以是单个分支名，也可以是分支数组（比如[master, main]），但格式必须符合YAML规范。

额外实用提示 #

修改完配置后，建议先在CircleCI控制台的配置编辑器里使用Validate Config功能做语法校验，提前排查格式问题，避免提交后触发错误。

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