CI/CD / 系统课时
安装依赖与缓存
安装依赖与缓存
这一课解决流水线里最常见的时间浪费:每次任务都重新下载依赖。目标是在不牺牲可重复构建的前提下,用锁文件驱动安装,并缓存包管理器下载目录,让后续运行只处理真正变化的依赖。
学习目标
- 使用锁文件和确定性命令安装依赖,避免 CI 与本地结果漂移。
- 为依赖缓存选择稳定且不会相互污染的失效条件。
- 通过连续两次流水线运行验证缓存是否真正生效。
先保证依赖安装可重复
缓存只能加速下载,不能替代依赖版本控制。以 Node.js 项目为例,仓库应提交 package-lock.json,流水线使用 npm ci,而不是会修改锁文件的 npm install。npm ci 会严格按锁文件安装;锁文件与 package.json 不一致时直接失败,适合作为 CI 的确定性入口。
在已经提交 package.json 与 package-lock.json 的项目根目录执行:
npm ci --silent
test -d node_modules && echo "dependencies ready"预期输出
dependencies ready如果第一条命令失败,应先修复锁文件或依赖声明,不要通过关闭校验来让流水线“继续跑”。
在流水线中启用依赖缓存
以 GitHub Actions 为例,actions/setup-node 可以直接缓存 npm 的下载缓存目录。它不会缓存 node_modules,因此每次任务仍会按锁文件重新组装依赖,只是大量包不必重新从网络下载。
下面是一份可直接放入 .github/workflows/ci.yml 的最小配置:
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 是正常行为,因为缓存负责减少下载,锁文件才负责决定最终安装结果。