如何在.gitlab-ci.yml中实现无覆盖的模板继承链？

能不能实现无覆盖继承？ #

可以，但要注意：YAML原生的锚点合并（<<: *anchor）对同名键是覆盖式替换，比如你示例里的script，父模板的npm install会被子模板的surge命令完全替换，这就是你当前遇到的“覆盖”问题。要实现无覆盖（数组追加、哈希合并），需要用特定的语法技巧。

你的示例问题分析 #

你当前的代码里：

• &deploy模板用<<: *basic_deploy合并基础配置，但script键直接被重写，导致基础模板的npm install命令丢失。
• include是用来引入外部CI配置文件的，不能用来合并锚点模板，注释掉的写法是错误的。

正确的无覆盖继承实现方式 #

方式1：手动锚点拆分+组合（原生YAML支持）

把需要复用的数组/哈希单独拆成锚点，在子模板里手动组合，避免覆盖：

# 拆分基础脚本为单独锚点
.basic_deploy_scripts: &basic_deploy_scripts
  - npm install --global surge

.deploy_template_basic: &basic_deploy
  script: *basic_deploy_scripts

.deploy_template: &deploy
  <<: *basic_deploy
  cache: []
  only:
    - main
  # 合并基础脚本+新增部署脚本
  script:
    - *basic_deploy_scripts
    - surge --project ./public --domain $DOMAIN
  # 拆分环境配置为单独锚点，方便后续合并
  .deploy_env: &deploy_env
    url: http://$DOMAIN
  environment: *deploy_env

deploy review:
  <<: *deploy
  stage: deploy review
  variables:
    DOMAIN: random_name-$CI_ENVIRONMENT_SLUG.surge.sh
  only:
    - merge_requests
  # 合并父模板的环境配置+新增字段
  environment:
    <<: *deploy_env
    name: review/$CI_COMMIT_REF_NAME
    on_stop: stop review
  before_script:
    - echo -e "\033[1;35mStage began deploy review"

stop review:
  <<: *basic_deploy
  stage: deploy review
  only:
    - merge_requests
  variables:
    GIT_STRATEGY: none
  before_script:
    - echo -e "\033[1;31mRemove review app"
  # 合并基础脚本+删除命令
  script:
    - *basic_deploy_scripts
    - surge teardown random_name-$CI_ENVIRONMENT_SLUG.surge.sh
  when: manual
  environment:
    name: review/$CI_COMMIT_REF_NAME
    action: stop

方式2：用GitLab CI原生的extends+!reference（更简洁）

GitLab CI 13.9及以上版本支持!reference关键字，配合extends可以更优雅地实现无覆盖合并，无需手动拆分锚点：

.deploy_template_basic:
  script:
    - npm install --global surge

.deploy_template:
  extends: .deploy_template_basic
  cache: []
  only:
    - main
  # 引用父模板的script并追加新命令
  script:
    - !reference [.deploy_template_basic, script]
    - surge --project ./public --domain $DOMAIN
  environment:
    url: http://$DOMAIN

deploy review:
  extends: .deploy_template
  stage: deploy review
  variables:
    DOMAIN: random_name-$CI_ENVIRONMENT_SLUG.surge.sh
  only:
    - merge_requests
  # 引用父模板的environment并追加新字段
  environment:
    !reference [.deploy_template, environment]
    name: review/$CI_COMMIT_REF_NAME
    on_stop: stop review
  before_script:
    - echo -e "\033[1;35mStage began deploy review"

stop review:
  extends: .deploy_template_basic
  stage: deploy review
  only:
    - merge_requests
  variables:
    GIT_STRATEGY: none
  before_script:
    - echo -e "\033[1;31mRemove review app"
  script:
    - !reference [.deploy_template_basic, script]
    - surge teardown random_name-$CI_ENVIRONMENT_SLUG.surge.sh
  when: manual
  environment:
    name: review/$CI_COMMIT_REF_NAME
    action: stop

方案实用性分析 #

• 适用场景：当项目有大量重复CI配置（比如多个部署任务都需要安装依赖、设置通用环境变量）时，无覆盖继承能大幅减少代码冗余，降低后续维护成本。
• 注意事项：如果继承链过长（超过3层），会增加配置的可读性成本，建议控制层级，同时给模板/锚点起清晰的命名。
• 替代方案：如果只是简单的配置复用，直接用extends（默认会覆盖同名键）也能满足需求，无覆盖继承更适合需要保留父模板所有配置的场景。

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