安全清理 Xcode DerivedData、建置快取與未使用的模擬器
逐步開發人員指南,可在不破壞建置環境的情況下清理 Xcode DerivedData、模組快取和 Mac 上未使用的 iOS 模擬器。

對iOS、macOS和visionOS開發者來說,Xcode是必備的工具。但它也可能成為開發人員 Mac 上的重要儲存消耗者。經過數月的建置、測試和調試,Xcode 累積了索引儲存、中間建置工件、模組快取、存檔和模擬器運行時。
隨著時間的推移,Xcode 建置目錄和模擬器可能會消耗大量磁碟空間,具體取決於活動項目、依賴項和模擬器運行時的數量。當儲存空間不足時,建置操作會變慢,並且可能會出現索引問題。以下是如何在不破壞專案配置的情況下安全地清理 Xcode DerivedData、建置快取和未使用的 iOS 模擬器。
什麼是 Xcode DerivedData 以及它為何成長?
Xcode 將建置時資訊儲存在位於 ~/Library/Developer/Xcode/DerivedData 的中央目錄中。在此目錄中,Xcode 為您開啟的每個專案和工作區建立專用子資料夾。
DerivedData 包含: 1. 索引資料:用於程式碼完成和快速幫助的語法映射、符號圖和交叉引用。 2. 建置產品:中間目標檔案 (.o)、預編譯框架和 dSYM。 3. 模組快取:預先編譯的 Swift 和 Clang 模組。由於來自舊版本、重新命名的目標或存檔分支的工件可能會累積,因此 DerivedData 往往會擴展,直到被清除為止。
刪除DerivedData安全嗎?
DerivedData 包含 Xcode 通常可以重新建立的生成建置和索引資料。刪除它可能會觸發完全重建和重新索引,因此請確認您刪除的是 DerivedData 而不是項目或存檔資料。
當 Xcode 行為不穩定、顯示持久建置錯誤或無法解析 Swift Package Manager 依賴項時,清除 DerivedData 是 Apple 開發者社群中的標準故障排除步驟。請記住,後續建置將花費更長的時間,因為 Xcode 必須重新索引您的程式碼庫並重新編譯依賴項。
手動清潔 DerivedData 的方法
您可以使用 Xcode 設定或 Finder 手動清理 DerivedData,或透過終端機:
• 透過Xcode 設定與Finder(建議):開啟Xcode → 設定(Command + ,)→ 位置。在「衍生資料」下,按一下路徑旁的小箭頭圖示以開啟 Finder 中的資料夾。確認您位於 DerivedData 中,退出 Xcode,然後選擇項目子資料夾並將其移至 垃圾桶。這允許您檢查正在刪除的內容,並在需要時從 垃圾桶 恢復檔案。
• 透過終端機(進階):如果您喜歡命令列工作流程,請先退出 Xcode 並執行: rm -rf ~/Library/Developer/Xcode/DerivedData/* 。請注意,rm -rf 會立即永久刪除文件,而不將它們移動到 垃圾桶,因此在運行之前請仔細驗證路徑。
清潔未使用的 iOS、watchOS 和 tvOS 模擬器
透過 Xcode 下載的每個模擬器運行時都會消耗幾 GB 的儲存空間。隨著時間的推移,隨著新作業系統更新的安裝,舊的模擬器版本仍保留在您的磁碟機上。
若要檢查已安裝的模擬器,請在終端機中執行 xcrun simctl list。若要刪除不可用或孤立的模擬器裝置並清除其快取,請執行 xcrun simctl delete unavailable。您也可以導覽至 Xcode 設定 → 元件來檢視、管理和刪除不再測試的已下載平台模擬器執行時間。
將 Smart Cleaner AI 與 Xcode 儲存維護一起使用
管理開發人員儲存時,目視檢查有助於識別驅動器容量集中的位置。
Smart Cleaner AI 的磁碟分析器可以幫助您檢查系統中掃描器可見的儲存量大的資料夾和檔案。 Xcode 特定的清理(例如管理 DerivedData、建置產品和模擬器)仍應使用 Xcode 設定、Finder 和開發人員命令列工具進行審查和執行,以便專案配置保持完整。
4 步驟清理 Xcode DerivedData 與模擬器
- 1
徹底退出Xcode
在執行任何快取刪除之前,請確保 Xcode 和所有活動模擬器實例已關閉。
- 2
在Finder中找到DerivedData
開啟 Xcode 設定 → 位置,然後點選 DerivedData 旁的箭頭,或直接導覽至 Finder 中的 ~/Library/Developer/Xcode/DerivedData。
- 3
刪除 DerivedData 建構子資料夾
選擇 DerivedData 中不需要的項目資料夾並將其傳送至 垃圾桶。 Xcode 將在重建時重新建立新索引。
- 4
在組件或終端機中管理模擬器
在終端機中使用 xcrun simctl delete unavailable,或開啟 Xcode 設定 → 組件來刪除未使用的模擬器執行時間。
常見問題
刪除 DerivedData 會刪除我的原始碼或 Git 歷史記錄嗎?▼
不。 DerivedData 僅包含臨時建置工件和索引。您的專案檔案、原始程式碼和 Git 儲存庫完全保持不變。
為什麼刪除 DerivedData 後我的第一次建置速度很慢?▼
因為Xcode必須重建其內部符號索引並從頭開始重新編譯Swift套件。隨後的增量構建將恢復全速。
Xcode 檔案儲存在哪裡?▼
Xcode 將分發檔案儲存在 ~/Library/Developer/Xcode/Archives/ 中。您可以透過 Xcode 管理員(視窗 → 管理器)檢視和刪除舊的開發檔案。
我可以將 DerivedData 移到外部 SSD 嗎?▼
是的,在 Xcode 設定 → 位置中,您可以在外部 NVMe 驅動器上設定自訂 DerivedData 路徑,儘管內部 Mac SSD 提供更快的建置吞吐量。
開發人員應該多久清理一次 DerivedData?▼
開發人員通常在對索引或編譯錯誤進行故障排除時、在主要 Xcode 更新後或從舊的、不活動的專案中回收儲存時清理 DerivedData。
資料來源
Ready when you are
Download Smart Cleaner AI for Mac
Analyze Mac storage, safely clear system data caches, find large files, and remove app leftovers with on-device controls.
By using Smart Cleaner AI, you agree to our Terms of Use and Privacy Policy.