# 為什麼 rust-cache 沒讓你的 Rust CI 變快（tauri：246 秒變 53 秒）

> Swatinem/rust-cache 快取的是你的相依套件，不是你的 workspace crate，而且會關掉增量編譯。所以在 GitHub 全新的 VM 上，每個預熱後的作業都要重新編譯你自己的 crate。在持續存在的機器上保留 target/ 就能解決：tauri 的 CI 作業在 Skipbox 上從 246 秒降到 53 秒，每月固定 $39。

Swatinem/rust-cache 是大多數 Rust CI 裡的快取步驟，它儲存你的相依套件，並刻意排除你的 workspace crate。它也會設定 `CARGO_INCREMENTAL=0`。在 GitHub 的 Runner 上，每個作業都從新的 VM 開始，所以每個預熱後的作業，就算快取完全命中，都要重新編譯你自己的 crate。沒有任何 rust-cache 設定能讓這件事消失。能做到的，是上一個作業留下來的 `target/`：這樣 Cargo 就會跳過每個沒有變動的 crate。

Skipbox 替你保留它。你的作業在帳號的專屬機器上執行，這台機器在作業之間保留 checkout 和 Cargo 的 `target/`。tauri 的 CI 作業在 GitHub 上花 246 秒，在那裡花 53 秒，從第一次預熱後的執行起就沒有編譯任何一個 crate，工作流程除了 `runs-on: skipbox` 之外什麼都沒改，每月固定 $39。

- tauri 的 CI 作業：GitHub 上 246 秒，Skipbox 上 53 秒（快 4.6 倍）。每次執行都是公開的
- 保留 `target/` 之後，Cargo 沒有編譯 tauri 的任何一個 crate：它的建置時間從 62 秒降到不到 2 秒
- 4 vCPU 每月 20,000 分鐘：GitHub 上要 $222，Skipbox 上是 $39

**GitHub Actions 固定價格，分鐘數不限** Skipbox 在你的專屬機器上執行 GitHub Actions 作業：每月 $39，不論執行多少分鐘。Docker 層和相依套件快取在作業之間保留，下一個作業馬上就能開始。

4 vCPU Runner，每月 20,000 分鐘: GitHub $222 → Skipbox $39. 每月省下 $183.

換過來只要改一行：`runs-on: skipbox`。

[開始 7 天免費試用](https://app.skipbox.dev/sign-in?ref=g-rust-cache-slow-rust-ci-zh-hant)

## rust-cache 保留什麼、排除什麼

依 [rust-cache 的 README](https://github.com/Swatinem/rust-cache#cache-details) 和它的原始碼：

- **它快取什麼：** `~/.cargo`（registry、git 相依套件、安裝的執行檔），以及含有你相依套件建置輸出的 `./target`。
- **它排除什麼：** workspace crate 本身不會被快取。在儲存之前，它的清理會刪掉 `target/` 中不是相依套件的所有東西，所以你的 crate 的產物會從 `target/` 本身被移除。
- **增量編譯：** 還原步驟會在作業的其餘部分匯出 `CARGO_INCREMENTAL=0`。
- **什麼時候儲存：** 只有在還沒有快取擁有這個作業的 key 時。key 來自工具鏈、環境，以及你的 `Cargo.lock` 和 `Cargo.toml`。你的原始碼檔案不在其中。

在全新的 VM 上，這些加起來就是一件事。預熱後的作業還原你的相依套件，然後完整編譯你的 workspace crate 以及建立在它們之上的所有東西，每一次都是。

## 機制，從 tauri 的紀錄來看

tauri 的 `test` 作業在 Ubuntu 上執行五個 `cargo test` 步驟，使用 rust-cache。以下是它預熱後的執行，每一次都是快取完全命中（紀錄中的 `full match: true`）：

| 預熱後的執行 | `Compiling` 行數 | Cargo 的建置時間 | 作業 |
|---|---|---|---|
| [GitHub](https://github.com/skipbox-dev/tauri/actions/runs/43234522982) | 32 | 118 秒 | 271 秒 |
| [Skipbox，全新 VM](https://github.com/skipbox-dev/tauri/actions/runs/43291768486) | 32 | 62 秒 | 146 秒 |
| [Skipbox，專屬機器，第 1 次預熱後的執行](https://github.com/skipbox-dev/tauri/actions/runs/43340142076) | **0** | **約 1.5 秒** | **53 秒** |
| [Skipbox，專屬機器，第 2 次預熱後的執行](https://github.com/skipbox-dev/tauri/actions/runs/43340289959) | **0** | **約 1.9 秒** | **53 秒** |

那 32 行是 tauri 自己的 crate，以及建立在它們之上的兩個外掛。相依套件從來不會出現：它們來自快取。Cargo 的建置時間是五個步驟的 `Finished … in` 時間加總。

全新 VM 和專屬機器有一樣的 CPU 和一樣的快取，而它編譯了和 GitHub 一樣的 32 個 crate：它的 `target/` 只有快取還原的東西。在專屬機器上，第一次預熱後的執行就已經沒有任何 `Compiling` 行。Cargo 只檢查了沒有東西變動，每個 `Finished` 花 0.2-0.7 秒。

專屬機器的第一次預熱後執行，過去會把 32 個 crate 全部重新編譯一次（[一個 114 秒的作業](https://github.com/skipbox-dev/tauri/actions/runs/43307552081)），因為 rust-cache 在冷執行之後的儲存，把它們從 `target/` 刪掉了。從 2026 年 11 月 13 日起，專屬機器會在 rust-cache 的還原和儲存步驟結束後，把它們從磁碟刪掉的東西復原。它儲存的快取一樣，而你的 crate 會留在 `target/` 裡。

## 作業時間：三個 Rust 專案，以及另外六個

真實專案自己的 CI 作業，在固定的 commit 上，步驟一個位元組都沒改；只改了觸發條件和 `runs-on`。每一邊都是一次冷執行，再加兩次預熱後的執行：

- **GitHub：** `ubuntu-24.04`，公開儲存庫的標準 Runner：4 vCPU，16 GB。
- **Skipbox，全新 VM：** 每個作業從正式環境的 Runner 映像檔建立一台新的 VM，4 vCPU 和 8 GB，快取透過 Skipbox 的快取還原。
- **Skipbox，專屬機器：** 同樣的規格，在同樣的主機 CPU 上，在作業之間保留下來，並執行專屬機器從 2026 年 11 月 13 日起的保留與清除：checkout 和 `target/` 會留下來，rust-cache 刪掉的東西會被放回去。

Skipbox 的執行是在 Skipbox 主機上，位於和客戶機器隔開的實驗專案中。時間是從每個作業開始到結束，取自 GitHub 的 API。每個數字是兩次預熱後執行的中位數。專屬機器的冷執行，tauri 花了 [285 秒](https://github.com/skipbox-dev/tauri/actions/runs/43339483384)，ripgrep 花了 [161 秒](https://github.com/skipbox-dev/ripgrep/actions/runs/43340538466)，helix 花了 [442 秒](https://github.com/skipbox-dev/helix/actions/runs/43336739720)。

| 專案 | GitHub | Skipbox，全新 VM | Skipbox，專屬機器 | GitHub ÷ 專屬機器 |
|---|---|---|---|---|
| tauri | 246 秒（[220](https://github.com/skipbox-dev/tauri/actions/runs/43233861304)、[271](https://github.com/skipbox-dev/tauri/actions/runs/43234522982)） | 210 秒（[273](https://github.com/skipbox-dev/tauri/actions/runs/43290912312)、[146](https://github.com/skipbox-dev/tauri/actions/runs/43291768486)） | **53 秒**（[53](https://github.com/skipbox-dev/tauri/actions/runs/43340142076)、[53](https://github.com/skipbox-dev/tauri/actions/runs/43340289959)） | **4.6×** |
| ripgrep | 200 秒（[194](https://github.com/skipbox-dev/ripgrep/actions/runs/43220584380)、[206](https://github.com/skipbox-dev/ripgrep/actions/runs/43221108547)） | 156 秒（[155](https://github.com/skipbox-dev/ripgrep/actions/runs/43292759363)、[156](https://github.com/skipbox-dev/ripgrep/actions/runs/43293273127)） | **40 秒**（[39](https://github.com/skipbox-dev/ripgrep/actions/runs/43340925562)、[40](https://github.com/skipbox-dev/ripgrep/actions/runs/43341036341)） | **5.0×** |
| helix | 330 秒（[293](https://github.com/skipbox-dev/helix/actions/runs/43227916673)、[366](https://github.com/skipbox-dev/helix/actions/runs/43228816343)） | 350 秒（[439](https://github.com/skipbox-dev/helix/actions/runs/43287815770)、[260](https://github.com/skipbox-dev/helix/actions/runs/43289134146)） | **224 秒**（[222](https://github.com/skipbox-dev/helix/actions/runs/43337749813)、[226](https://github.com/skipbox-dev/helix/actions/runs/43338273330)） | **1.5×** |

ripgrep 在 cross 的 Docker 映像檔裡建置。cross 自己建立 `target/`，並把它標記為「created by cross」。專屬機器過去會把那個 `target/` 當成不是 Cargo 的東西，在每個作業後刪掉，所以 Cargo 每次執行都要重新編譯每個 crate（一個 108 秒的作業）。現在 cross 的 `target/` 會留下來：預熱後的執行沒有任何 `Compiling` 行，每個 `Finished` 花 0.04-0.05 秒。GitHub 每次執行還要下載 cross 的映像檔（第二次預熱後的執行花了 30 秒）；專屬機器則把它留在磁碟上。

helix 也快了 1.5×。它的 crate 中只有 helix-term（以及依賴它的 xtask）會重新建置，因為 helix-term 的建置指令碼每個作業都會執行：在 `test` profile 中花 16 秒，在 `integration` profile 中花 61 秒。沒有其他 crate 被編譯。helix 的作業大部分是測試：光是整合測試套件就跑了 112 秒。它的準備步驟，也就是工具鏈和快取還原，花了 9-10 秒，在 GitHub 上是 41-46 秒。

其他語言：

| 專案 | 語言 | GitHub | Skipbox，專屬機器 |
|---|---|---|---|
| [astro](https://github.com/skipbox-dev/astro/actions) | Node.js | 528 秒 | **30 秒** |
| [vite](https://github.com/skipbox-dev/vite/actions) | Node.js | 141 秒 | 100 秒 |
| [prometheus](https://github.com/skipbox-dev/prometheus/actions) | Go | 335 秒 | 273 秒 |
| [cli](https://github.com/skipbox-dev/cli/actions) | Go | 163 秒 | 137 秒 |
| [pytest](https://github.com/skipbox-dev/pytest/actions) | Python | 416 秒 | 365 秒 |
| [guava](https://github.com/skipbox-dev/guava/actions) | Java | 818 秒 | 651 秒 |

astro 和 `target/` 是同樣的故事，只是換成 Turborepo：專屬機器保留了 turbo 的快取（turbo 2），所以它預熱後的執行從快取重播全部 40 個建置任務和測試任務，而不是重新執行它們（[31 秒](https://github.com/skipbox-dev/astro/actions/runs/43351547473)、[28 秒](https://github.com/skipbox-dev/astro/actions/runs/43351638436)）。

私有儲存庫的 `ubuntu-latest` 只有 2 顆 CPU 和 8 GB：是上面 GitHub 執行的一半核心。

## 檢查你自己的 CI

1. 打開你的 Rust 作業的一次預熱後執行，也就是 rust-cache 步驟紀錄顯示 `full match: true` 的那一次。
2. 在建置和測試步驟中，數一數 `Compiling` 行。來自快取的相依套件不會印出任何一行。你的每個 workspace crate 會印出一行，建立在它們之上的每個 crate 也是。
3. 把各步驟的 `Finished … in` 時間加起來。那就是你自己的 crate 每次執行的成本，也是它們沒有變動時，保留的 `target/` 能省下的時間。

## 在 GitHub 的 Runner 上能做什麼

- **`cache-workspace-crates: true`**（rust-cache v2.8.0 以上）。你的 crate 也會進入快取。但 key 已經存在的執行會略過儲存，而 key 不會隨你的原始碼改變，所以快取中的 crate 就停在最後一次儲存時那麼舊。增量編譯仍然是關閉的，而快取會在 GitHub 每個儲存庫 10 GB 的額度內變大。
- **sccache。** 它依輸入快取每一次編譯，所以沒有變動的函式庫 crate 會從儲存空間回來。會呼叫連結器的 crate 無法快取：執行檔、`dylib`、`cdylib` 和 proc-macro crate 每次都要編譯，而每次命中都是一次下載。
- **保留 `target/` 的自架 Runner。** 機器要你自己維運：修補它、在作業之間清理又不刪掉 `target/`，並在 actions/checkout 上設定 `clean: false`，因為它預設的 `git clean -ffdx` 會把 `target/` 和其他所有被忽略的檔案一起刪掉。

## Skipbox 替你保留 target/

每個方案都附有一台你帳號專屬、在作業之間保留下來的機器。從 2026 年 11 月 13 日起，它會保留你的 checkout（連同檔案的時間），以及 Cargo 的 `target/`：

- actions/checkout 的清理照常執行，只是不會動到 Cargo 的 `target/` 目錄。
- rust-cache 留在你的工作流程裡。它的還原不再用快取中較舊的產物覆寫磁碟上較新的產物。
- rust-cache 的儲存和還原從 `target/` 和 `~/.cargo` 刪掉的東西，機器會在步驟結束後放回去。儲存的快取一樣，而從冷執行之後的那個作業起，沒有變動的 crate 就不會被編譯。
- cross 建立的 `target/`（標記為「created by cross」）也會留下來。
- actions/checkout 每個作業都會重寫 `.git/HEAD`。只要它還指向同一個 commit，這個檔案就會拿回原本的時間，所以監看 `.git/HEAD` 的建置指令碼（vergen 就是）不會單單因為這樣就重新執行。

機器也會保留 Docker 映像檔、套件快取和安裝好的工具，所以作業的其他部分也一起加速。作業依標籤選擇規格：

| 標籤 | 機器 | 方案 |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S，每月 $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | M，每月 $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | L，每月 $149 |

分鐘數不限。4 vCPU 每月 20,000 分鐘，GitHub 收 $222；Skipbox S 是 $39，少了 $183。

## 換過去只要改一行

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: cargo test --workspace
```

1. 使用 GitHub 登入 Skipbox。
2. 安裝 Skipbox GitHub App，並選擇儲存庫。
3. 修改 `runs-on` 並推送。

## 安全性

- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除，保留下來的 checkout 中的 Git 憑證、hook 和未追蹤的檔案也是。開啟「每個作業都用新 VM」，每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新、用完即丟的機器上執行，沒有保留的 `target/`。

詳情請見[作業如何隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 用你的 Rust 作業試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把你的 Rust 作業改成 `runs-on: skipbox`，執行兩次，再把第二次執行的 `Compiling` 行數和 GitHub 上的並排比較。

## 常見問題

### Swatinem/rust-cache 會快取我的 workspace crate 嗎？

預設不會。它的 README 說，workspace crate 本身不會被快取，而它的儲存步驟在上傳快取之前，會從 target/ 刪掉它們的建置輸出。它快取的是 ~/.cargo 和你的相依套件的建置輸出，並在作業的其餘部分設定 CARGO_INCREMENTAL=0。所以在全新的 GitHub VM 上，每次預熱後的執行，即使快取完全命中，也要重新編譯你的 workspace crate。在 tauri 於 GitHub 上的 CI 中，每次預熱後的執行都有 32 行 Compiling。

### 我應該設定 cache-workspace-crates: true 嗎？

它也會把你的 crate 放進快取（rust-cache v2.8.0 以上），但快取的 key 來自你的工具鏈、你的環境，以及你的 Cargo.lock 和 Cargo.toml，而不是你的原始碼。key 已經存在的執行會略過儲存，所以快取中你的 crate 的副本，就停在最後一次儲存時那麼舊，每個 commit 都讓它和你的程式碼差得更遠。增量編譯仍然是關閉的。看看預熱後執行的紀錄：如果你的 crate 還是顯示 Compiling，它就沒有幫上忙。

### sccache 能解決 GitHub Actions 上 Rust CI 很慢的問題嗎？

它對輸入沒有變動的函式庫 crate 有幫助。sccache 無法快取會呼叫連結器的 crate（bin、dylib、cdylib 和 proc-macro crate），而每次命中都是從它的快取儲存空間下載。在作業之間保留的 target/ 不需要任何下載：Cargo 認為沒有變動的 crate，根本不會被編譯。

### 要在 Skipbox 上保留 target/，需要修改工作流程嗎？

不用。把 runs-on 改成 skipbox，rust-cache 和 actions/checkout 維持原樣。你的專屬機器在作業之間保留 checkout 和 Cargo 的 target/，checkout 的清理不會動到 target/ 目錄。rust-cache 的儲存從 target/ 刪掉你的 crate 時，機器會把它們放回去，它的還原也不再用較舊的產物覆寫較新的。所以從第一次預熱後的執行起，沒有變動的 crate 就不會被編譯。

### 試用要花多少錢？

不用錢。試用為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把你的 Rust 作業改成 runs-on: skipbox，執行兩次，再把第二次執行的 Compiling 行數和建置步驟與 GitHub 上的比較。

更新於 2026-11-16 · https://skipbox.dev/zh-hant/guides/rust-cache-slow-rust-ci
