GitLab CI include配置合并异常 build作业依赖install未定义报错

你遇到的build job undefined dependency install报错和CI配置单文件校验无关，核心问题是根目录.gitlab-ci.yml的include写法不符合YAML语法规则：

• YAML中同一层级重复声明同名键时，后面的键值会直接覆盖前面的内容
• 你先后写了两次include，第一次引入的/ci/install_stage.yml会被第二次引入覆盖，最终合并完成的CI配置里完全不存在install作业，build作业声明依赖install自然会报找不到依赖的错误。
• GitLab CI的lint校验是在所有include文件全部合并完成后执行的，不存在单文件单独校验的逻辑。

1. 修正根目录.gitlab-ci.yml的include写法，将多个引入文件改为数组格式，避免配置被覆盖：

stages:
  - install
  - build

before_script:
  - nvm install 14.17
  - nvm use 14.17
  - npm install -g yarn@1.10.1 --registry=$NPM_REGISTRY
  - npm install -g semantic-release
  - git fetch --all

include:
  - '/ci/install_stage.yml'
  - '/ci/build_stage.yml'

2. （可选优化）修正/ci/build_stage.yml中cache key的变量拼写错误，你漏写了CI_COMMIT_REF_SLUG的变量前缀$，修正后配置：

build:
  stage: build
  tags:
    - fe
    - xdev
  artifacts:
    expire_in: 1 day
    paths:
      - $CI_PROJECT_DIR/dist
  only:
    changes:
      - .gitlab-ci.yml
      - package.json
      - packages/**/*
  script:
    - yarn build
  dependencies:
    - install
  cache:
    key: '$CI_PROJECT_PATH-$CI_COMMIT_REF_SLUG-build'
    paths:
      - $CI_PROJECT_DIR/dist

3. （可选优化）由于你给install和build都配置了only: changes规则，要保证两个作业的触发规则完全一致，避免出现触发流水线时install作业因规则不匹配被跳过、build作业找不到依赖的情况。如果需要更灵活的作业依赖控制，也可以将dependencies替换为needs关键字，支持跨阶段依赖和依赖跳过策略配置。

改完上述配置后重新触发CI lint校验，报错就会消失，build作业会严格等待install作业执行成功后才会运行。

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