Gitlab CI/CD 如何设置可被项目配置覆盖的环境变量默认值

首先给出明确结论：你提供的写法不可行，无法实现「优先使用项目配置值，无配置时使用默认值」的预期效果。

原写法无效的原因 #

Gitlab 对 .gitlab-ci.yml 中 variables 块的解析发生在配置加载阶段，该阶段仅做基础的变量值替换，不会执行任何Shell逻辑运算。你写的 $VAR || "default" 会被直接识别为普通字符串：

• 若用户在项目设置中配置了VAR值为custom，最终变量值会变成custom || "default"
• 若用户未配置VAR，最终变量值会变成空字符串拼接 || "default"，即 || "default"
  完全不符合使用需求。

正确实现方案 #

方案1：Gitlab 13.1+ 原生支持（推荐） #

Gitlab 13.1及以上版本原生支持变量默认值配置，且自动遵循Gitlab默认的变量优先级规则（项目/组/实例级配置的变量 > .gitlab-ci.yml中定义的默认值），写法如下：

variables:
  VAR:
    value: "default"
    description: "可在项目CI/CD设置中自定义覆盖，默认值为default"

该写法完全匹配你需要的「有自定义配置优先用配置值，无配置用默认值」的需求。

方案2：低版本Gitlab兼容方案 #

如果使用的Gitlab版本低于13.1，不支持上述语法，可以在Job的执行脚本中用Shell参数扩展实现：

your_job:
  script:
    # 仅当VAR未赋值/值为空时，才会设置为默认值default
    - VAR=${VAR:-"default"}
    # 后续业务逻辑正常使用$VAR即可
    - echo $VAR

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