透過 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 專案的範例工作流程：