如何避免GitLab Pipeline每个阶段从头开始执行？

一、是否可行？ #

完全可行。GitLab CI/CD提供了**缓存（cache）和工件（artifacts）**两种核心机制，专门用来解决阶段间重复执行冗余步骤的问题，实现前序输出的复用。

二、具体配置方案 #

1. 用工件（Artifacts）传递构建产物与依赖 #

工件是阶段间传递文件的官方标准方式，适合保存构建后的二进制文件、编译产物、依赖目录等内容，会被上传至GitLab服务器，供后续阶段按需下载使用。
示例配置（以Node.js项目为例）：

stages:
  - build
  - test

build:
  stage: build
  image: node:18-alpine
  script:
    - npm install # 下载依赖
    - npm run build # 构建应用
  artifacts:
    paths:
      - node_modules/ # 保存依赖目录
      - dist/ # 保存构建产物
    expire_in: 1 week # 设置过期时间，避免占用过多存储

test:
  stage: test
  image: node:18-alpine
  script:
    - npm run test # 直接复用已有依赖和构建产物，无需重复执行install和build
  dependencies:
    - build # 显式指定依赖build阶段的工件，避免下载无关阶段的文件

2. 用缓存（Cache）加速依赖复用 #

缓存主要用于在多次流水线或同流水线的阶段间复用依赖包（如npm的node_modules、Python的site-packages），它存储在Runner本地或分布式缓存服务中，比工件更轻量，适合频繁复用的场景。
示例配置：

cache:
  key: ${CI_COMMIT_REF_SLUG} # 按分支设置缓存键，不同分支的缓存相互隔离
  paths:
    - node_modules/ # 缓存依赖目录

stages:
  - build
  - test

build:
  stage: build
  image: node:18-alpine
  script:
    - npm install # 若缓存存在则跳过重新下载，直接复用
    - npm run build

test:
  stage: test
  image: node:18-alpine
  script:
    - npm run test # 直接使用缓存的依赖

注意：缓存不保证100%可用（如Runner更换、缓存清理），建议和工件配合使用，兼顾效率和可靠性。

3. 同阶段任务的复用 #

如果同阶段有多个任务需要共享前置操作的结果，可以通过needs指定任务依赖，让前置任务先执行并传递工件：

stages:
  - test

test_setup:
  stage: test
  script:
    - npm install
  artifacts:
    paths:
      - node_modules/

test_unit:
  stage: test
  needs: [test_setup]
  script:
    - npm run test:unit

test_e2e:
  stage: test
  needs: [test_setup]
  script:
    - npm run test:e2e

这样test_unit和test_e2e都会复用test_setup的依赖，无需各自执行安装步骤。

三、为什么默认各阶段从头执行？ #

1. 环境隔离与可靠性：每个阶段默认在独立的Runner环境中执行，避免前阶段的残留文件、环境变量或依赖冲突污染当前环境，确保每个阶段的执行结果不受其他步骤影响，保证流水线的稳定性和可重复性。
2. 分布式执行适配：GitLab CI/CD支持分布式Runner部署，不同阶段可能在不同的Runner上运行（比如Build用Linux Runner，Test用Windows Runner），默认从头执行可以适配这种跨环境的分布式场景，不需要依赖特定Runner的本地状态。
3. 幂等性与可重试性：CI/CD的最佳实践要求任务具备幂等性（重复执行结果一致），默认从头执行让每个阶段都可以单独重试或调试，不需要依赖前序阶段的状态，降低故障排查的复杂度。

内容的提问来源于stack exchange，提问作者Mr-IDE