| GitLab | cache:key:files 用文件内容生成键（上限 2 个文件） |
|---|---|
| GitHub | actions/cache 的 key 常配 hashFiles('**/package-lock.json') |
| 分层键 | restore-keys 提供前缀回退，允许部分命中 |
GitHub
GitHub
- uses: actions/cache@v4
with:
path: ~/.npm
key: npm-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
npm-${{ runner.os }}-GitLab
GitLab
cache:
key:
files: [package-lock.json]键过于笼统（如固定 v1）会命中过期依赖；键过于具体（含提交号）则几乎无法复用。