GitLab CI/CD的.gitlab-ci.yml含空格字符串为何验证失败？

问题复现 #

编辑.gitlab-ci.yml的after_script字段时出现如下矛盾现象：

• 无空格写法（可正常运行）：

  build_appliance:
    after_script:
      - "PRIVATE-TOKEN:$EXAMPLE_TOKEN"
  

  GitLab Pipeline Editor提示Pipeline syntax is correct，流水线执行无异常。
• 添加空格后的写法：

  build_appliance:
    after_script:
      - "PRIVATE-TOKEN: $EXAMPLE_TOKEN"
  

  GitLab编辑器报错：This GitLab CI configuration is invalid: jobs:build_appliance:after_script config should be a string or a nested array of strings up to 10 levels deep.，提交后流水线运行失败，但在线YAML验证器判定该内容语法合法。

原因分析 #

YAML语法本身允许双引号字符串内包含空格，但GitLab的CI解析器对after_script这类脚本字段有额外的格式校验逻辑——当双引号字符串内出现空格时，解析器会错误地将其识别为非单一字符串/数组结构，触发不符合预期的校验错误，这属于GitLab CI解析器的特定兼容性问题。

解决办法 #

1. 移除空格（最直接）：保持PRIVATE-TOKEN:$EXAMPLE_TOKEN无空格的格式，规避解析异常。
2. 改用单引号包裹：单引号在YAML中会被解析为纯字符串，不会触发GitLab的额外结构校验：

   build_appliance:
     after_script:
       - 'PRIVATE-TOKEN: $EXAMPLE_TOKEN'
   

3. 显式使用数组包裹：将命令放在数组中，明确告知解析器这是单一命令项：

   build_appliance:
     after_script:
       - ["PRIVATE-TOKEN: $EXAMPLE_TOKEN"]
   

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