通过 actions/cache 加速 GitHub Actions 工作流程

Thu, 20 Nov 2025 00:00:00 +0900

自动化 CI/CD 管道（如 GitHub Actions）是现代软件质量控制的基石。但是，如果您的工作流程在每个拉取请求上获取外部包、启动容器环境并从头开始重建整个应用程序，则执行时间可能会迅速增加到几分钟。

较长的反馈循环会降低开发人员的工作效率并导致更高的计费成本。

在本文中，我们将演示如何利用 GitHub 的官方缓存机制将您的工作流程从几分钟加快到几秒钟。

1. GitHub Actions 中的缓存如何工作

GitHub Actions 缓存将文件（例如包依赖项和构建输出）保存到 GitHub 管理的安全存储层。在后续运行中，运行程序将恢复这些目录，而不是重新下载或编译它们。

缓存对于以下方面非常有效：

包管理器缓存文件夹（例如 .npm 或 yarn 缓存）。
Web 框架构建目标（例如 Next.js 中的 .next/cache）。
编译器中间体（Rust 目标目录、Go 构建缓存）。

2. 使用 `setup-*` 操作进行本机包缓存

为 Node.js 等运行时环境启用缓存的最简单方法是通过 GitHub 官方设置操作中的集成选项。

使用 npm (`.github/workflows/ci.yml`) 的 Node.js 项目的示例工作流程：

name: CI

on: [push, pull_request]

jobs:
 build:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout repository
 uses: actions/checkout@v4

 - name: Set up Node.js
 uses: actions/setup-node@v4
 with:
 node-version: 20
 # Enable automatic caching for npm dependencies
 cache: 'npm'

 # Automatically restores dependency cache mapping package-lock.json hashes
 - name: Install dependencies
 run: npm ci

 - name: Run test
 run: npm test

只需设置 cache: 'yarn' 或 cache: 'pnpm' 即可分别处理 Yarn 和 pnpm 设置，无需任何其他配置。

Ci-Cd on 技术、游戏、生活通俗易懂的解释

通过 actions/cache 加速 GitHub Actions 工作流程

1. GitHub Actions 中的缓存如何工作

2. 使用 setup-* 操作进行本机包缓存

使用 npm (.github/workflows/ci.yml) 的 Node.js 项目的示例工作流程：

2. 使用 `setup-*` 操作进行本机包缓存

使用 npm (`.github/workflows/ci.yml`) 的 Node.js 项目的示例工作流程：