GitLab CI引入含数组的文件后Job配置缺失问题排查

你的核心问题是引入配置文件后，build-test job完全从最终配置中消失且无报错提示，以下是可能的原因和解决办法：

1. YAML缩进或格式错误 #

GitLab CI对YAML缩进要求严格，必须使用2个空格层级缩进，绝对不能用制表符。如果build-test的缩进比.default-changes深，会被识别为前者的子项而非独立job，导致GitLab无法解析。

• 检查配置文件缩进：确保.default-changes和build-test处于同一层级（无缩进），job内部的stage、rules等字段都缩进2个空格。

2. if条件的引号格式错误 #

你代码中的"是HTML转义字符，实际YAML中应替换为真实的双引号，否则条件会被解析为无效字符串，可能导致整个rules块失效，进而让job被忽略。
修正后的条件写法：

rules:
  - if: '$CI_COMMIT_BRANCH == "develop"'
    changes: *default-changes

或者用外层双引号包裹、内层单引号的形式，避免转义问题：

rules:
  - if: "$CI_COMMIT_BRANCH == 'develop'"
    changes: *default-changes

3. 文件引入方式错误 #

如果主.gitlab-ci.yml的include路径不正确，或者文件扩展名不是.yml/.yaml，会导致配置合并失败。
确保主文件的include语句正确：

include:
  - local: '相对路径/你的配置文件.yml'

注意路径是相对于仓库根目录的相对路径。

4. 隐藏字符干扰 #

配置文件中如果存在制表符、不可见控制字符，会导致YAML解析异常，但GitLab可能不会明确报错，而是直接忽略错误部分。

• 用文本编辑器打开文件，开启“显示所有字符”功能，检查并删除制表符或隐藏字符。

5. 逐步排查简化配置 #

如果以上方法都无效，先写一个极简的测试job：

test-simple:
  stage: build
  script: echo "hello"

将这个配置引入主文件，看是否出现在最终配置中。如果出现，再逐步添加rules、changes、锚点等内容，定位具体哪部分导致job消失。

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