Rust 建置分析

Build Insights 協助你找出拖慢 Cargo 建置的原因，並在影響整個團隊之前捕捉回歸問題。你可以將本機建置與 CI 進行比較、觀察建置時間的變化，並檢查每次建置中編譯的 crate。

回報你的建置#

透過 Tuist 執行你慣用的 Cargo 指令：

如果你使用 mise，請 設定 Cargo 包裝器 以繼續使用一般的 cargo 指令。你的參數、工具鏈選擇、輸出與結束代碼皆保持不變。

找出拖慢建置的原因#

在儀表板的 Builds → Build Runs 中開啟一個建置。使用日期、環境與 Rust 版本篩選器來比較相似的建置。你也可以透過 tuist build cargo list 與 tuist build cargo show、GET /api/projects/{account_handle}/{project_handle}/cargo/builds，以及 list_cargo_builds 與 get_cargo_build MCP 工具 取得建置與其快取計數。

在 Overview 中，使用 Compiler jobs 找出耗時的 crate。可依 Duration 或 Started after（自 Cargo 指令啟動後的經過時間）排序，或依 crate 名稱或根原始檔搜尋。

每一列代表對某個 crate 的一次 rustc 呼叫，該 crate 可能包含多個原始檔。Crate root 標示其根原始檔；持續時間是整次編譯工作的時間，而非僅該檔案。同一個 crate 可能因不同目標或設定而出現多次。編譯器訊息會歸類於 Warnings 與 Errors。

跨建置追蹤 crate#

對於已加入逐步推出之 crate 歷史記錄功能的專案，Builds → Crates 會顯示觀察到的 crate 及其編譯歷史。開啟某個 crate 以比較其在各建置中的記錄持續時間與結果，並可追溯該次編譯回到對應的 Cargo 建置。相同的清單也可透過專案 API 中的 /cargo/crates 以及共用 MCP 建置實體工具（搭配 kind: cargo_crates）取得。

crate 會依據其精確記錄的根路徑、名稱與種類分組。變更 checkout 路徑可能會使歷史記錄分裂；設定檔、功能與目標三元組不會被區分。這是觀察到的編譯工作清單，並非你工作區中的所有 crate。已快取或已是最新的 crate 不會產生編譯樣本。

歸屬建置報告#

經驗證的報告可識別個人憑證背後的個人。共用憑證不一定需要識別個人。你可選擇在回報機器上將 TUIST_ACTOR_ID 設為穩定的不透明識別碼；預設為關閉，並以未經驗證的聲明顯示，絕不用於授權。較舊的伺服器可能會忽略此聲明。請勿在其中放置機密資訊。

解讀時間數據#

建置持續時間是指整個 Cargo 指令所花費的時間。編譯工作可以平行執行，因此它們的持續時間總和不等於建置持續時間。

Cargo 只會編譯需要重新建置的 crate。已是最新的 crate 不會出現在編譯器清單中。使用 Tuist 的編譯快取時，還原的工作會出現在快取測量中，而非作為編譯器執行。

Tuist 不會單獨測量建置腳本，也不會顯示建置時間軸。大型建置會顯示前 500 個編譯工作，若記錄了更多工作則會顯示提示。

解讀快取測量#

tuist cargo 包含由 Tuist CLI 實作的實驗性編譯快取。請參閱 Rust 快取指南 以了解設定、透過 Kura 進行的遠端讀寫、支援的編譯，以及疑難排解。

在專案側邊欄開啟 Cargo Cache，以追蹤跨建置的快取命中率，以及記錄的傳輸、延遲與吞吐量測量。可依日期或環境篩選、在每日趨勢與單次建置命中率之間切換，或開啟最近的建置以檢查其快取活動。沒有快取測量的建置之資料仍顯示為不可用，而非計為零。

開啟建置的 Cache 頁籤，查看任務命中、任務未命中、命中率，以及下載與上傳的位元組數。當建置回報快取資料時，此頁籤才會出現。

• Cacheable Tasks 顯示哪些編譯器與建置腳本任務重複使用了快取輸出。你可以搜尋或篩選任務、檢查快取讀寫延遲，並展開某列以查看其輸出。
• CAS Outputs 顯示構件的下載與上傳，包含其大小、持續時間與吞吐量。圖表統計已完成的傳輸；已存在的構件與失敗嘗試仍會保留在表格中。

Hit 表示重複使用了快取輸出。Missed 表示任務改為進行編譯。命中不會區分為本機與遠端；CAS Outputs 會顯示記錄的構件操作。

如果詳細記錄遺失或不完整，頁面會顯示提示。摘要仍涵蓋整個建置。估計避免的編譯器工作 不等於節省的实际建置時間。

執行測試的建置#

tuist cargo test 會回報整個指令（包含其測試）的持續時間。它也透過 Rust Test Insights 回報個別測試結果，包含文件測試。個別測試結果會顯示在 Tests 下方；指令持續時間則出現在建置分析中。

其他編譯器工具#

Tuist 會保留透過 RUSTC_WRAPPER、CARGO_BUILD_RUSTC_WRAPPER 或 Cargo 設定所設定的現有編譯器包裝器，並保持 RUSTC_WORKSPACE_WRAPPER 不變。既有的全域包裝器會停用 Tuist 的快取與編譯器觀察器：Tuist 無法確認該包裝器是否確實執行了 rustc。自訂工作區包裝器也可能導致報告中的編譯工作較少。

Tuist 會透過 rustup 尋找 Cargo。如果你使用自訂安裝，請將 TUIST_CARGO_EXECUTABLE 設為其可執行檔路徑。直接以工具鏈路徑呼叫 Cargo 會繞過 mise 的包裝器。Cargo 別名無法取代如 build 等內建指令。

如果你使用 Cargo 的 nightly -C 選項，請先切換到工作區目錄：Tuist 會轉發 -C 指令，但不會收集其建置時間。

疑難排解#

如果建置未出現在儀表板中，請啟用除錯輸出以查看報告未傳送的原因：

回報不會改變你的建置結果。