首页/开发/CI/CD 与发布速查/GitHub Actions 缓存
工具链要点63 条

GitHub Actions 缓存

用 actions/cache 缓存依赖目录:key 常用锁文件哈希,restore-keys 提供前缀回退;缓存按仓库额度管理与淘汰。

CI/CD 与发布速查开发更新于 2026-10-12
key唯一键,建议含 OS 与锁文件哈希
restore-keys前缀回退匹配
额度仓库级缓存总量有上限,长期未访问被淘汰
内置setup-* 动作自带缓存参数

缓存 npm

缓存 npm
- uses: actions/cache@v4
  with:
    path: ~/.npm
    key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
    restore-keys: |
      npm-${{ runner.os }}-
锁文件进 key:依赖更新自动换缓存,减少手工清理。

易错点

  • 把构建产物塞进缓存:分支间互相污染,产物应走 artifacts
  • key 未含 OS:跨平台命中同一缓存导致运行失败

数据来源与参考

  • GitHub Docs《Caching dependencies to speed up workflows》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌