缓存键怎么设计

缓存键决定命中率与正确性：按依赖锁文件哈希生成键，依赖变更自动失效，避免用错缓存。GitLab 用 cache:key:files 以文件内容生成键（上限 2 个文件）；GitHub 的缓存动作常用文件哈希函数计算锁文件摘要；分层键用 restore-keys 提供前缀回退，允许部分命中。设计口径：键跟随依赖源变化，而不是跟随时间或提交号。键过于笼统（如固定 v1）会命中过期依赖；键过于具体（含提交号）则几乎无法复用。

基本信息

典型使用场景

• 依赖缓存：lockfile 哈希作为键，依赖变更自动换缓存。
• 分层回退：先精确命中，未命中退回前缀缓存实现部分命中。
• 分支隔离：键加分支前缀，避免功能分支与主干互相覆盖。
• 多包管理器：npm、pip、Go 各自建键，互不干扰。
• 命中率监控：观察命中率变化定位键设计问题。
• 清缓存演练：定期从空缓存跑一次，确认流程不依赖缓存也能通过。

GitHub 分层键

- uses: actions/cache@v4
  with:
    path: ~/.npm
    key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      npm-${{ runner.os }}-

GitLab 按锁文件

cache:
  key:
    files: [package-lock.json]