如何在gitlab-ci中将GitLab CI变量设置为数组类型

GitLab CI 中的 variables 定义的所有变量默认都是字符串类型，不存在原生数组类型。你原配置中直接把字符串格式的变量传给要求数组类型的 dependencies 关键字，GitLab 解析时会识别到传入的是单个字符串而非字符串数组，因此抛出格式错误。

方案1：使用YAML锚点&别名（推荐，同配置内复用场景） #

如果你的依赖数组只需要在当前 .gitlab-ci.yml 文件内复用，直接使用YAML原生的锚点特性即可，不需要走CI变量定义，兼容性最好，无版本要求：

# 提前定义依赖数组锚点
.deps_config: &deps_list
  - dependency1
  - dependency2
  - dependency3

# 作业中直接引用锚点别名
your_job:
  dependencies: *deps_list
  script:
    - echo "作业逻辑执行"

方案2：使用JSON解析语法（动态传参场景） #

如果你需要通过CI变量动态传入依赖列表（比如触发流水线时自定义、上游流水线传值），可以使用GitLab 14.3及以上版本支持的parseJson表达式，将JSON格式的字符串变量解析为数组：

variables:
  # 变量值写为合法JSON字符串，用单引号包裹避免YAML提前解析
  DEPENDENCY_LIST: '["dependency1", "dependency2", "dependency3"]'

your_job:
  # 用GitLab表达式把JSON字符串转成数组
  dependencies: $[[ parseJson(variables.DEPENDENCY_LIST) ]]
  script:
    - echo "作业逻辑执行"

• 方案1不需要依赖GitLab版本，语法更简洁，优先选择。
• 方案2要求GitLab版本≥14.3，且需要确保变量值为标准JSON格式，否则会解析失败。

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