CI/CD / 系统课时

安装依赖与缓存

安装依赖与缓存

这一课解决流水线里最常见的时间浪费:每次任务都重新下载依赖。目标是在不牺牲可重复构建的前提下,用锁文件驱动安装,并缓存包管理器下载目录,让后续运行只处理真正变化的依赖。

学习目标

  • 使用锁文件和确定性命令安装依赖,避免 CI 与本地结果漂移。
  • 为依赖缓存选择稳定且不会相互污染的失效条件。
  • 通过连续两次流水线运行验证缓存是否真正生效。

先保证依赖安装可重复

缓存只能加速下载,不能替代依赖版本控制。以 Node.js 项目为例,仓库应提交 package-lock.json,流水线使用 npm ci,而不是会修改锁文件的 npm install。npm ci 会严格按锁文件安装;锁文件与 package.json 不一致时直接失败,适合作为 CI 的确定性入口。

在已经提交 package.json 与 package-lock.json 的项目根目录执行:

bash
npm ci --silent
test -d node_modules && echo "dependencies ready"

预期输出

text
dependencies ready

如果第一条命令失败,应先修复锁文件或依赖声明,不要通过关闭校验来让流水线“继续跑”。

在流水线中启用依赖缓存

以 GitHub Actions 为例,actions/setup-node 可以直接缓存 npm 的下载缓存目录。它不会缓存 node_modules,因此每次任务仍会按锁文件重新组装依赖,只是大量包不必重新从网络下载。

下面是一份可直接放入 .github/workflows/ci.yml 的最小配置:

yaml
name: ci

on:
  push:
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: npm
          cache-dependency-path: package-lock.json
      - run: npm ci

这段配置的关键不是“有缓存”三个字,而是缓存失效与锁文件绑定:当 package-lock.json 变化时,会使用新的依赖缓存键;锁文件未变化时,后续任务可以复用已经下载过的包。

验证缓存是否真的有效

验证时不要只看“任务成功”,而要比较两次相同依赖状态的运行。第一次运行可视为冷启动,第二次在不修改 package-lock.json 的情况下重新触发流水线。

检查第二次运行中 setup-node 的缓存恢复日志,并对比依赖安装步骤耗时。随后修改一个依赖并提交新的锁文件,再运行一次;此时应看到缓存键随锁文件变化,而不是错误复用旧依赖状态。

如果第二次运行完全没有缓存恢复迹象,优先检查三点:锁文件路径是否写对、包管理器是否与配置一致、流水线运行身份是否具备读取先前缓存的条件。缓存命中后依然执行 npm ci 是正常行为,因为缓存负责减少下载,锁文件才负责决定最终安装结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装依赖与缓存

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通