Skipbox

為什麼 rust-cache 沒讓你的 Rust CI 變快(tauri:246 秒變 53 秒)

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。

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

依 rust-cache 的 README 和它的原始碼:

  • 它快取什麼: ~/.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):

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

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

專屬機器的第一次預熱後執行,過去會把 32 個 crate 全部重新編譯一次(一個 114 秒的作業),因為 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 秒,ripgrep 花了 161 秒,helix 花了 442 秒。

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 秒。

其他語言:

astro 和 target/ 是同樣的故事,只是換成 Turborepo:專屬機器保留了 turbo 的快取(turbo 2),所以它預熱後的執行從快取重播全部 40 個建置任務和測試任務,而不是重新執行它們(31 秒、28 秒)。

私有儲存庫的 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 映像檔、套件快取和安裝好的工具,所以作業的其他部分也一起加速。作業依標籤選擇規格:

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

換過去只要改一行

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/。

詳情請見作業如何隔離。

用你的 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日

快取隨時熱機,CI/CD 更快

固定價格的專屬熱機 Runner

機器由 Skipbox 代管。你只要改一行。滿載使用時只要 GitHub 的 1/12。價格固定,可以整天跑。快取空間是 GitHub 的 7 倍。

  • 不需信用卡
  • 使用 GitHub 登入
  • 隨時可取消