Xcode 快取

Tuist 支援 Xcode 編譯快取，讓團隊能利用建置系統的快取能力，共享編譯產物。

Xcode 快取於 Xcode 26 引入。你也可能看到它被稱為 Xcode 建置快取；它會根據輸入內容重用編譯產物，而 Tuist 的遠端快取讓這些產物能在不同機器之間共享。

與模組快取搭配使用

Xcode 快取與模組快取在不同粒度層級運作，並互為補充。模組快取在建置執行前，以預先建置的.xcframework取代整個模組；Xcode 快取則在建置期間重用編譯輸出。

在開發者機器上清理時，保留CompilationCache.noindex

預設情況下，編譯快取儲存區位於DerivedData內，因此刪除DerivedData會連同建置產物一起移除。在開發者機器上，建議只刪除建置產物：重新建置時會從磁碟上的儲存區重放，無需抓取任何資料。

設定#

如果你還沒有 Tuist 帳號與專案，可以執行以下指令來建立：

bash

tuist init

一旦你擁有參照你的fullHandle的Tuist.swift檔案，就可以執行以下指令為專案設定快取：

bash

tuist setup cache

此指令會建立一個LaunchAgent，在啟動時執行本機快取服務，供 Swift 建置系統用來共享編譯產物。請先在開發者機器上執行，並將其作為每個 CI 工作設定的一部分。

若要在 CI 上設定快取，請確認你已通過驗證。

快取代理程式使用穩定的啟動器，而非綁定到上次執行設定的 Tuist 安裝路徑。安裝後，tuist setup cache與啟用快取的tuist generate會將可用目標推進至較新的 Tuist 版本。因此，綁定到較舊 Tuist 的專案不會降級共享的代理程式。產生作業只會更新現有的啟動器目標：它不會安裝服務、進行驗證、替換外掛程式或重新啟動代理程式。自訂的外掛程式、代理程式、通訊端或註冊表覆寫會跳過自動推進。

執行中的代理程式只會在至少 30 秒沒有快取請求、沒有任何進行中的請求或背景工作，且其發布佇列已排空的情況下，才會採用新目標。隨後它會退出，由 launchd 啟動所選的 CLI，並保留服務的參數與憑證環境。只有實際採用目標的代理程式會以原子方式從其套件刷新磁碟上的外掛程式；在舊版代理程式仍在排空時，設定不會安裝較新的外掛程式。如果已安裝的外掛程式遺失，明確的空閒設定會重新啟動所選代理程式以重試刷新。仍只有一個代理程式擁有註冊表與佇列。不可用的目標或未排空的上傳會延遲切換，而不會中斷進行中的請求。憑證刷新會跟隨所選的 CLI，甚至在切換之前，因此移除較舊的 CLI 安裝不會讓等待排空的上傳陷入停滯。

在穩定啟動器之前建立的現有安裝需要一次明確的遷移。在沒有建置執行時執行以下指令：

bash

tuist setup cache

完成該遷移後，更新 Tuist 並執行你慣用的tuist generate即可推進代理程式與已安裝的外掛程式；你不需要為每個 CLI 版本重新執行設定。若要選擇不同的 Xcode（包括在同一路徑更新的 Xcode），仍需要明確的設定。當共享服務的配置變更時，設定可以替換該服務，因此請先等待機器上的所有建置完成。代理程式同時支援先前的外掛程式協定與目前的協定，因此已在 Xcode 中載入的相容外掛程式在代理程式升級後仍可繼續運作。完全關閉並重新開啟 Xcode 以載入最新的外掛程式，但已載入的相容外掛程式不需要立即重新啟動。當版本變更所產生的建置設定時，請重新產生專案。

保持所選的 Tuist 安裝可用：啟動器會使用它來啟動、設定與刷新憑證。一旦啟動器已推進，即可移除較舊的安裝。如果所選的可執行檔已被刪除或不再可執行，tuist setup cache可以使用可用的安裝（甚至是較舊的版本）修復目標，而無需先拆除快取。穩定的可執行檔別名在套件管理器升級期間會保留；只有在比較安裝身分時才會解析符號連結。啟動時，代理程式會記錄實際啟動的版本（包括就地更新或刻意回滾），同時保留最高使用版本，以防止不相關的舊版檢出切換可用的安裝。

未帶發行版本的原始碼建置 CLI，以及明確的TUIST_CAS_PLUGIN_PATH或TUIST_CAS_PROXY_PATH設定，會使用明確的啟動配置，而非自動版本選擇。重建這些元件後，請重新執行設定。設定會檢查其新鮮度，並在其替代方案就緒後才停用受管理的目標推進。

tuist teardown cache會在移除啟動器目標之前停止服務，同時為現有專案保留穩定的外掛程式。如果停止服務失敗，其啟動器仍可供重新啟動與再次嘗試拆除。成功拆除後，產生作業無法重新建立服務。

設定 Xcode 建置設定#

對於現有的 Xcode 專案，請將tuist setup cache輸出的建置設定複製到專案的「Build Settings」或現有的.xcconfig檔案中。該指令會列印你帳號的配置；它不會產生設定檔或編輯你的 Xcode 專案。在擴充OTHER_SWIFT_FLAGS時請保留$(inherited)，以確保其他編譯器選項得以保留。

設定包含：

bash

COMPILATION_CACHE_ENABLE_CACHING = YES
COMPILATION_CACHE_ENABLE_PLUGIN = YES
COMPILATION_CACHE_PLUGIN_PATH = $HOME/.local/state/tuist/libtuist_cas_plugin.dylib
COMPILATION_CACHE_REMOTE_SERVICE_PATH = $HOME/.local/state/tuist/cas-proxy.sock
COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES = YES
COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS = YES
OTHER_SWIFT_FLAGS = $(inherited) -cas-plugin-option tuist-instance=your-org/your-project

請注意，COMPILATION_CACHE_ENABLE_PLUGIN、COMPILATION_CACHE_PLUGIN_PATH、COMPILATION_CACHE_REMOTE_SERVICE_PATH與COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES需要作為使用者定義的建置設定加入，因為它們並未直接在 Xcode 的建置設定 UI 中公開。

外掛程式路徑

libtuist_cas_plugin.dylib是隨 Tuist 一起提供的編譯快取外掛程式，位於tuist可執行檔旁邊。tuist setup cache會將其複製到$HOME/.local/state/tuist/libtuist_cas_plugin.dylib，而COMPILATION_CACHE_PLUGIN_PATH則指向該副本。此路徑在每台機器上都相同，且在你更新 Tuist 時不會改變，因此你可以將此設定與專案一起提交。設定程序與新啟動的代理程式會從所選的 Tuist 套件刷新該副本；從較舊的檢出版本執行設定不會降級較新的外掛程式。

每個專案使用同一個 Socket

tuist setup cache會在每台機器上安裝單一快取代理程式，因此每個專案都使用相同的COMPILATION_CACHE_REMOTE_SERVICE_PATH。tuist-instance外掛程式選項是用來識別專案的依據。

COMPILATION_CACHE_REMOTE_SERVICE_PATH負責共享 C 與 Objective-C

很容易將此設定解讀為「快取服務所在的位置」並視為可選。但它也是決定是否共享 C、Objective-C、預編譯模組與預編譯標頭檔的開關：只有在設定了遠端快取服務時，建置系統才會對這些項目執行快取。若省略此設定，你仍然可以共享 Swift 編譯結果，但在任何尚未建置過該專案的機器上，每個 C/Objective-C 檔案與每個模組都會重新編譯。

並行快取查詢

COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES會讓建置系統為每次編譯執行的遠端快取查詢與其餘建置工作並行執行，而不是在建置的執行通道上一次只處理少數幾個。當許多編譯從遠端快取未命中或還原時，建置會更快完成。

你也可以在執行xcodebuild時透過加入以下旗標來指定這些設定，例如：

bash

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    COMPILATION_CACHE_ENABLE_CACHING=YES \
    COMPILATION_CACHE_ENABLE_PLUGIN=YES \
    COMPILATION_CACHE_PLUGIN_PATH=$HOME/.local/state/tuist/libtuist_cas_plugin.dylib \
    COMPILATION_CACHE_REMOTE_SERVICE_PATH=$HOME/.local/state/tuist/cas-proxy.sock \
    COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES=YES \
    COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS=YES \
    'OTHER_SWIFT_FLAGS=$(inherited) -cas-plugin-option tuist-instance=your-org/your-project'

Xcode 27 及更高版本的前綴映射

在 Xcode 27 及更高版本中，tuist setup cache也會列印SWIFT_ENABLE_PREFIX_MAPPING、SWIFT_ENABLE_PROJECT_PREFIX_MAPPING、CLANG_ENABLE_PREFIX_MAPPING與CLANG_ENABLE_PROJECT_PREFIX_MAPPING。它們讓編譯快取金鑰獨立於專案與DerivedData所在的位置。請將它們作為使用者定義的建置設定加入。啟用它們會改變每個快取金鑰，因此下一次建置會再次填充快取。當enableCaching開啟時，tuist generate會為你設定這些值。

編譯器也會將映射後的路徑寫入程式碼涵蓋率資料中，而 Xcode 無法解析它們，因此涵蓋率報告會遺漏所有使用前綴映射編譯的原始碼。列印的設定以及TUIST_PREFIX_MAPPING_FOR_COVERAGE_*相關設定，會在收集程式碼涵蓋率的建置中關閉前綴映射。tuist generate也會執行相同操作。這些建置仍然使用編譯快取，但其快取金鑰取決於專案與DerivedData路徑。

當你在命令列將這些設定傳遞給xcodebuild時，請對包含$(...)的值使用單引號，如同上方的OTHER_SWIFT_FLAGS。否則 Shell 會將它們展開為空字串，導致前綴映射被關閉：

bash

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    'SWIFT_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \
    SWIFT_ENABLE_PROJECT_PREFIX_MAPPING=YES \
    'CLANG_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \
    CLANG_ENABLE_PROJECT_PREFIX_MAPPING=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_NO=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_YES=NO

產生的專案

如果你的專案是由 Tuist 產生的，則無需手動設定這些設定。

在這種情況下，你只需在Tuist.swift檔案中加入enableCaching: true：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

使用前綴映射的涵蓋率#

預設情況下，產生的專案會為涵蓋率建置停用前綴映射，以確保 Xcode 的涵蓋率報告與xccov正常運作。你可以啟用它，讓涵蓋率編譯在不同檢出之間可共享：

swift

let tuist = Tuist(
    project: .tuist(
        generationOptions: .options(
            enableCaching: true,
            coverage: .coverage(prefixMapping: true)
        )
    )
)

TUIST_COVERAGE_PREFIX_MAPPING環境變數（1或0）優先於prefixMapping。此選項適用於 Xcode 27 及更高版本，且需要enableCaching。涵蓋率tuist test上傳支援此功能：Tuist 使用llvm-cov測量執行過程，它會讀取具有映射路徑的原始碼，並將它們對應回你儲存庫中的檔案。Xcode 自身的涵蓋率報告與xccov仍可能遺漏這些原始碼，若llvm-cov匯出失敗而回退至結果套件的xccov報告，上傳也可能遺漏它們。映射後的#filePath值也可能影響相對於原始碼檔案定位測試資源的測試；請改為透過明確的執行時期檢出路徑來解析測試資源。如果你自行處理涵蓋率，請將每個插樁後的二進位檔與其目標的$(TARGET_TEMP_DIR)/compilation-prefix-map.json配對，該檔案會將虛擬前綴映射回本機目錄。當啟用每專案映射時，請勿將單一目標的映射重複用於每個二進位檔。

涵蓋率前綴設定會參與二進位快取與選擇性測試的雜湊計算，因為它們控制寫入涵蓋率產物的路徑。變更此選項，或以不同方式設定TUIST_COVERAGE_PREFIX_MAPPING，即使對於一般建置也會使這些雜湊失效。如果開發人員與 CI 工作應該共享二進位快取與選擇性測試結果，請保持該值一致。

除錯產生的專案#

還原的原生模組需要連結的除錯資訊以及存取編譯快取的權限。Tuist 會使用 dSYM 與每切片原始碼身分中繼資料來暖化 Debug 與 Release 模組，然後在替換目標之前，根據消費者宣告的原始碼驗證中繼資料。若中繼資料遺失或不相容，則會保留該目標的原始碼。腳本產生的.generated(...)原始碼擁有宣告指紋，而非可驗證的內容雜湊，因此這些目標會保持從原始碼建置，且不會發布至原生模組快取。具有實際內容雜湊的產生資源存取器仍然符合資格。不支援的除錯資訊會跳過受影響目標的發布，而不會封鎖不相關的產品；原始碼異動與取消仍會導致暖化失敗。快取格式已變更，因此由較舊版本暖化的產物需要重新暖化。

對於經驗證的替換，Tuist 會在消費者擁有的 dSYM UUID plist 中準備原始碼重新定位，並為靜態快取程式碼連結僅供除錯使用的伴隨檔案。它不會重寫快取的二進位檔，也不會在 LLDB 的持久全域原始碼地圖中安裝生產者原始碼路徑。明確的除錯器初始化器與模組載入器設定仍然具有權威性。除錯符號與原始碼重新定位不會修復相對於原始碼的執行時期檔案存取或原生 Xcode 涵蓋率報告；涵蓋率變體選擇與 LLVM 匯出仍然是獨立的功能。

啟用 enableCaching: true 時，Tuist 會為「執行」與「測試」動作設定 LLDB 原始碼地圖。若某個動作擁有自訂 LLDB 初始化器，Tuist 會先寫入已解析的原始碼地圖，接著載入該自訂初始化器，使其能夠擴充或覆寫地圖。否則，它會在替換原始碼地圖之前，先載入 ~/.lldbinit-Xcode（若檔案存在），並回退至 ~/.lldbinit。它只會載入一個主目錄檔案，以恢復每位使用者的除錯器設定，避免重複載入。此替換會移除先前執行留下的過時映射，且優先於主目錄檔案中的原始碼地圖；請將需要保留的原始碼地圖項目放入動作的自訂初始化器中。其他主目錄設定則會保留。Tuist 針對快取特定的模組搜尋路徑、載入器設定與 Clang 旗標會在之後套用，並優先於使用者對這些設定的值。主目錄檔案的錯誤仍會顯示，但不會阻止後續命令載入，且不會回顯命令。即使未啟用 enableCaching 或在較早版本的 Xcode 上，當 Tuist 為從模組快取還原的二進位檔設定除錯時，也會套用此初始化器保留機制。

在 Xcode 27 及更新版本中，除非專案明確設定，否則產生的專案會關閉 Xcode 的每個專案前綴映射（SWIFT_ENABLE_PROJECT_PREFIX_MAPPING 與 CLANG_ENABLE_PROJECT_PREFIX_MAPPING）。它們的前綴（例如 /^src）在每個專案中指向不同的目錄，而 LLDB 僅針對被除錯目標所屬的專案來解析它們。相反地，原始碼會記錄在工作區範圍的前綴之下：/^root 代表 Tuist 根目錄，/^spm 代表 Swift 套件暫存目錄，而 /^intermediates 與 /^products 代表建置產出。每個前綴在所有專案中都指向相同的目錄，因此中斷點能正確解析工作區中任何專案的原始碼。

Tuist 根目錄之外的路徑不會被映射。位於根目錄之外的專案，其快取金鑰取決於檢出位置，因此其他檢出副本與機器將無法命中該專案的快取。若要使其金鑰獨立於檢出位置，請在該專案的資訊清單中開啟每個專案的映射：

swift

let checkoutIndependentSettings = Settings.settings(base: [
    "SWIFT_ENABLE_PROJECT_PREFIX_MAPPING": "YES",
    "CLANG_ENABLE_PROJECT_PREFIX_MAPPING": "YES",
])

將這些設定傳遞給該 Project。當你除錯來自另一個專案的目標時，LLDB 將無法找到該專案的原始碼。資訊清單中的專案基礎設定優先於專案層級的 xcconfig 值，因此請直接在資訊清單中設定它們。

變更這些設定會改變編譯快取金鑰、二進位快取雜湊與選擇性測試雜湊，因此這些快取需要重新暖化。請在團隊中保持一致的選擇。

快取上傳政策#

預設情況下，快取服務會同時下載並上傳產物至遠端快取。你可以透過 Tuist.swift 檔案中的 xcodeCache 選項來控制此行為，以啟用唯讀模式，在此模式下會下載產物但絕不上傳：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        upload: false
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

常見的做法是僅從 CI 推送產物，因為那裡的建置是可重現的，同時保持本機環境為唯讀。你可以使用 Environment.isCI 來達成此目的，它會檢查大多數 CI 供應商設定的 CI 環境變數：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        upload: Environment.isCI
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

透過此設定，本機建置可以受益於快取產物而無需上傳，同時 CI 建置會為團隊其他成員填充快取。

上傳政策會記錄在執行 tuist setup cache 的機器上，並以專案為單位。若要變更它，請更新 upload 並再次執行 tuist setup cache，如果 Tuist 會產生你的專案，也請執行 tuist generate。之後的上傳將遵循新政策，無需重新啟動該機器上的快取。在同一台機器上同時執行的同一專案工作會共享其政策，因此最近的 tuist setup cache 將決定所有工作的政策。

儲存空間大小限制#

編譯快取儲存空間會隨著每次建置而成長。為了限制專案的儲存空間，請在 Tuist.swift 檔案中設定 storeSizeLimit：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        storeSizeLimit: .gigabytes(20)
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

當沒有建置正在執行時，Tuist 每 10 分鐘檢查一次專案的每個儲存空間。一旦較新的建置寫入了約一半的限制容量，它就會刪除儲存空間中最舊的快取產出，使儲存空間穩定在限制容量附近。在建置執行期間，儲存空間可能會超過限制容量；而若在設定限制時儲存空間已經較大，則在新建置寫入足夠資料後會縮小。當多個專案使用同一個儲存空間（如同預設位置的情況），則適用其中最小的限制。此限制適用於你執行 tuist setup cache 的每一台機器，因此在變更限制後請再次執行它。

模組快取雜湊#

編譯快取設定不屬於模組快取雜湊的一部分。Tuist 會將每個 COMPILATION_CACHE_* 建置設定，以及每個帶有值的 -cas-plugin-option 旗標排除在雜湊之外。開啟或關閉 enableCaching，或變更上傳政策，會保留你目標的雜湊，因此你已暖化的模組快取二進位檔仍然有效。你可以針對相同的模組快取，比較有與沒有 Xcode 快取的建置。

前綴映射設定會被雜湊

在 Xcode 27 及更新版本中，enableCaching: true 也會設定 SWIFT_ENABLE_PREFIX_MAPPING、SWIFT_ENABLE_PROJECT_PREFIX_MAPPING、CLANG_ENABLE_PREFIX_MAPPING、CLANG_ENABLE_PROJECT_PREFIX_MAPPING 以及 TUIST_PREFIX_MAPPING_FOR_COVERAGE_* 設定。這些設定屬於模組快取雜湊的一部分，因此在 Xcode 27 及更新版本中，開啟或關閉 enableCaching 會改變你目標的雜湊。

重用大型產物的部分內容#

Xcode 快取可以透過內容定義分塊來減少傳輸量。它不會將每個大型產物視為與早期版本無關，而是根據其內容在邊界處分割壓縮後的產物。編輯後，即使偏移量已改變，仍可重用匹配的區塊。

上傳僅發送伺服器缺少的區塊。下載時會先取得確切的快取動作與產物的分塊配方，然後重用儲存在本機機器上的已驗證區塊，並獲取缺失的部分。完整的重建產物在還原至編譯器快取之前會經過驗證。

傳輸分塊快取與 DerivedData 分開，因此其區塊可以在清理編譯快取或重新啟動本機快取服務後依然存在。它是可拋棄的，且分塊負載上限為一 GiB，另有一個最多兩 MiB 的臨時暫存檔案。被驅逐或損壞的區塊會在需要時重新下載。保留編譯快取本身仍然比重建其內容更快。

用戶端僅在伺服器宣告支援相容功能時，才會使用分塊傳輸。較舊的用戶端仍可讀取完整的產物，而連線至較舊或不支援伺服器的用戶端則維持一般傳輸。小型產物仍沿用現有的完整產物路徑。

這會減少傳輸位元組數，但不會減少編譯器失效。變更原始檔可能仍需編譯；分塊有助於發布或還原產生的產物。節省幅度取決於產物與編輯內容，若機器上沒有相符的區塊（冷啟動），則必須下載整個產物。

持續整合#

若要在 CI 環境中啟用快取，你需要執行與本機環境相同的指令：tuist setup cache。

進行驗證時，你可以使用 OIDC 驗證（建議用於支援的 CI 提供者），或是透過 TUIST_TOKEN 環境變數使用帳戶權杖。

以下是使用 OIDC 驗證的 GitHub Actions 工作流程範例：

yaml

name: Build

permissions:
  id-token: write
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jdx/mise-action@v2
      - run: tuist auth login
      - run: tuist setup cache
      - # Your build steps

請參閱持續整合指南以取得更多範例，包括基於權杖的驗證以及其他 CI 平台，例如 Xcode Cloud、CircleCI、Bitrise 和 Codemagic。

CI 上的編譯快取儲存區#

編譯快取儲存區是 Xcode 存放編譯產物的本機目錄。COMPILATION_CACHE_CAS_PATH 建置設定會設定其位置，預設為 DerivedData 內的 CompilationCache.noindex。

有狀態儲存區#

若要在建置之間保留儲存區，請將 COMPILATION_CACHE_CAS_PATH（以及用於 tuist cache 的 TUIST_COMPILATION_CACHE_CAS_PATH）指向一個持久化路徑，並透過儲存區大小限制限制其大小。

疑難排解#

建置警告指出 Xcode 快取代理程式失敗#

如果建置顯示如下警告，Xcode 會根據哪個編譯最先遇到失敗，在前方加上 CAS error: 或 CAS operation failed: 前綴：

yaml

warning: CAS error: The Tuist Xcode cache proxy at /Users/you/.local/state/tuist/cas-proxy.sock failed (proxy connect: No such file or directory (os error 2)). Compilations that needed it used the local cache only, without remote cache hits. Their uploads are kept on disk and sent once the proxy is reachable again. Run `tuist setup cache` if the proxy is not running.

這表示編譯快取無法連線至由 tuist setup cache 安裝的本機快取代理程式。建置仍然成功，但受影響的編譯無法命中遠端快取，因此表現如同空快取的建置。它們的上傳內容會保留在磁碟上，並在代理程式再次處理請求時發送：如果在同一個建置期間恢復連線，則會在該建置稍後階段發送；否則會在同一台機器的下一次建置期間發送。作業結束後即銷毀的 CI 機器會遺失這些資料。此警告在每次建置中僅出現一次，顯示於 Xcode 的問題導覽器以及 xcodebuild 輸出中。

若要檢查代理程式是否正在執行，請尋找監聽警告中所述 Socket 的處理程序：

bash

lsof ~/.local/state/tuist/cas-proxy.sock

如果指令未印出任何內容，請執行 tuist setup cache 以重新啟動代理程式。在 CI 上，請在每個作業中的任何 xcodebuild 呼叫之前執行 tuist setup cache。

建置極度緩慢並發出 `CAS error: deadlineExceeded` 警告#

如果你的建置耗時遠超預期，且 Xcode 建置記錄充滿如下警告：

bash

Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): No such file or directory (errno: 2)))
note: cache key query failed

或：

bash

Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): Connection refused (errno: 61)))

這表示 COMPILATION_CACHE_REMOTE_SERVICE_PATH 指向一個無人監聽的 Socket，通常是 Tuist 早期版本設定的每個專案專用 Socket（~/.local/state/tuist/<org>_<project>.sock）。Tuist 已不再提供該 Socket。Xcode 會在每次編譯快取請求時重試連線，而非快速失敗，這可能導致建置耗時一小時或更久，而 Tuist 無法改變此行為。

修復方法：

產生的專案：再次執行 tuist generate。
其他專案：將 COMPILATION_CACHE_* 建置設定替換為 tuist setup cache 所印出的設定，如設定 Xcode 建置設定所述。

如果你未使用 Xcode 快取，請改為移除 COMPILATION_CACHE_* 建置設定，並執行 tuist teardown cache。

即使已停用上傳，本地仍出現 `uploaded CAS output`#

當設定 xcodeCache: .xcodeCache(upload: false)（或在非 CI 機器上設定 upload: Environment.isCI）時，你仍可能在建置記錄中看到 note: uploaded CAS output ...。xcodebuild 無法略過這些呼叫，因此 Tuist 仍會接收它們，但不會向 Tuist 伺服器發布任何內容。儀表板指標已將此納入考量，因此不會報告虛假的上傳流量。