Vercel 在 2026 年 11 月 13 日把所有 build machine 的 build cache 上限提高到 5 GB,變更自動套用、不需設定,也沒有額外費用。先前 Basic 與 Standard 超過 1.5 GB、Enhanced 超過 3 GB、Turbo 超過 4.75 GB 時,cache 會被捨棄,下一次建置就失去可重用內容。對大型 monorepo、依賴多的前端或產生大量 framework cache 的專案,新的上限降低了「cache 太大而整包不保存」的機會。
但 5 GB 不是保證建置變快的開關。Build cache 是否能被重用,仍取決於 cache key、分支、Framework Preset、Root Directory、Node.js 版本與套件管理器等條件;失敗的 build 不會更新既有 cache。若瓶頸是遠端 API、下載沒有被快取的 binary、錯誤的 monorepo 觸發範圍,或每次部署都改變 key,容量增加可能幾乎沒有作用。
哪些專案最可能受益
第一類是過去 cache 接近或超過舊上限的專案。常見訊號包括:相同分支第二次建置仍重新安裝大部分依賴、build log 顯示 cache 未保存或未恢復,以及 package installation 時間在沒有 lockfile 變更時仍維持高檔。Basic 與 Standard 的上限增幅最大,因此原本介於 1.5 GB 到 5 GB 的 cache 最容易直接感受到差異。
第二類是 Next.js、Nuxt、Gatsby 等會保存 framework cache 的大型網站,以及有多個 workspace、共用工具鏈與多個 Vercel Functions 的 monorepo。官方文件說明,Next.js 的 .next/cache、Nuxt 的 .nuxt、Gatsby 的 .cache 與 public 等會依 Framework Preset 進入 cache;@vercel/node builder 也會處理 node_modules 與 .yarn/cache。函式數量與 runtime 也可能增加共享 cache 的大小。
第三類是 preview branch 密集的團隊。新分支第一次沒有自己的 cache 時,Vercel 會用最近的 production deployment cache 作為起點,後續才建立該分支的 cache。若 production cache 以前因容量超標而被捨棄,preview 的冷啟動成本會更明顯;上限提高後,有機會保留更完整的基線。
容量、磁碟與部署產物是三件不同的事
Build cache 是建置之間重用的內容,不等於 build container 的可用磁碟,也不等於部署產物大小。專案即使有 5 GB cache,建置過程仍可能因 machine 的 memory、disk space 或 45 分鐘時間限制而被取消;.vercel/output 也不會被放入 build cache,因為恢復它會讓新部署看起來像預先建好。
這個區分會影響診斷。若 log 是 out of memory 或 disk space 超限,不應把解法寫成「等 cache 上限生效」;應啟用 Vercel build system report,查看 source、node_modules、大檔案與資源使用。若是部署 storage 或舊 deployment 保留量增加,則要處理 retention 與產物,而不是 build cache。
也不要把 cache 當成 artifact store。需要在工作階段間可靠保存的測試報告、編譯產物或版本化模型,應放到明確的 artifact 或 object storage 流程;cache 可以被失效、保留期限有限,且內容由 Vercel 的 builder 與 framework 規則決定,官方目前不提供任意挑選快取檔案的設定。
用數據確認 5 GB 是否真的改善
先選一個常用 production 分支與一個 preview 分支,記錄更新前後至少各 5 次成功建置。分開量測 install、framework build、checking 與總時間,並註記 lockfile、Node.js、package manager、Root Directory 與 Framework Preset 是否改變。不要比較一次冷 build 與一次暖 build後就宣稱提升百分比,因為兩者輸入不同。
建議再做一次受控實驗:在同一 commit 正常 redeploy,確認使用既有 cache;接著取消「Use existing Build Cache」或用 vercel --force 做無 cache 部署,比較 log。若暖 build 沒有明顯差異,檢查 cache key 是否因分支或設定分裂、Framework Preset 是否正確,以及真正耗時的步驟是否屬於可快取範圍。
需要更完整的資源報告時,可在測試環境設定 VERCEL_BUILD_SYSTEM_REPORT=1,讓每次部署輸出報告。完成診斷後再決定是否保留,並避免把含敏感路徑或內部結構的 log 隨意公開。測量重點應是中位數與高分位建置時間、cache restore 結果、安裝時間與失敗率,而不是只看最快的一次。
Monorepo 的優化順序
第一步先修正會讓 cache key 無謂改變的設定,例如不同分支使用不一致的 Node.js 或 package manager。第二步確認 Root Directory 與 Framework Preset;設定錯誤不只降低命中,也可能讓應被保存的 framework 檔案沒有進入 cache。第三步縮小每次需要建置的 workspace 範圍,避免文件改動也重建所有應用。
第四步才檢查依賴體積。刪除未使用套件、避免把大型下載塞進 install script,通常同時改善冷建置與 cache 上傳。官方文件提到可在適合的專案排除 production 不需要的開發依賴,但前端 build 常常正需要 bundler、TypeScript 與測試工具,不能直接把 npm install --only=production 套到所有專案;必須以實際 build 驗證。
導入與回滾清單
這次變更不需要修改設定,因此最安全的做法是先觀察,不為了「用滿 5 GB」刻意增加 cache。建立兩週基線,確認 cache 被保存與恢復,並追蹤建置時間及費用是否下降。若更新依賴後出現難以重現的結果,可用 Dashboard redeploy 時取消既有 cache、vercel --force,或暫時設定 VERCEL_FORCE_NO_BUILD_CACHE=1 跳過恢復;成功建置仍會建立新 cache。
最終選擇也不應只在 Vercel 不同 machine type 間比較。若建置依賴非常特殊、需要自訂 cache 路徑或跨平台共享 artifact,獨立 CI 可能更可控;若主要需求是 Git push 後快速產生 preview,Vercel 自動管理的 cache 可以降低維運。5 GB 上限的實際價值,是讓更多現有專案不再因容量超標而整包失去 cache;是否值得調整架構,仍要由可重現的 build 數據決定。