GitLab CI中include规则的分支条件匹配失效问题

核心问题分析 #

你的include规则失效主要是正则表达式语法错误，以及对$CI_COMMIT_REF_NAME变量取值的误解：

1. 正则未匹配整个分支名：缺少开头锚定符^，导致部分匹配逻辑失效
2. 分支名中的斜杠未正确转义：Ruby风格正则中，用/作为分隔符时，分支名里的/需要转义为\/
3. 错误假设$CI_COMMIT_REF_NAME包含refs/heads/前缀：该变量直接返回分支名（如dev/production），完整引用路径是$CI_COMMIT_REF的取值

修正后的配置 #

include:
  - local: /workflows/.gitlab-web-app-react-workflow.yml
  - local: /trigger-jobs/.gitlab-trigger-job-templates.yml
  - local: /rules/.gitlab-integration-rules.yml
  - local: /templates/.gitlab-notification.yml
  # 匹配非dev/production的所有分支
  - local: /vars/deployment-environments/.gitlab-$CI_PROJECT_NAME-default-vars.yml
    rules:
      - if: '$CI_COMMIT_REF_NAME =~ /^(?!dev\/production$).*$/'
  # 仅匹配dev/production分支
  - local: /vars/deployment-environments/.gitlab-$CI_PROJECT_NAME-prod-vars.yml
    rules:
      - if: '$CI_COMMIT_REF_NAME =~ /^dev\/production$/'

额外注意事项 #

• 用单引号包裹if条件：避免YAML解析时将正则中的特殊字符误判为语法元素
• 验证文件路径：确保local路径中的$CI_PROJECT_NAME能正确解析，且目标文件存在于项目对应路径下
• 检查分支名拼写：确认分支名确实是dev/production，无大小写或字符拼写错误

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