如何安全刪除 Xcode Derived Data：釋放 Mac 儲存空間

可以，Xcode Derived Data 通常能安全刪除。預設資料夾裡存放的是 Xcode 可以重新產生的建置成果與索引，刪除後不會影響專案原始碼，但下一次建置和程式碼索引會花比較久的時間。

真正要留意的是刪除範圍：先結束 Xcode，並確認操作的是 ~/Library/Developer/Xcode/DerivedData，不要誤刪 Archives、模擬器裝置資料或專案資料夾。

本文所列路徑與檢查指令已於 2026 年 8 月 10 日在 macOS 15.7.7、Xcode 16.2 上驗證。Xcode 選單位置可能隨版本調整；若你沒有自訂建置位置，預設 Derived Data 路徑與下方的終端機操作仍然適用。

Xcode Derived Data 是什麼？

Xcode 會把建置專案與分析程式碼時產生的檔案放進 Derived Data，常見內容包括：

Apple 文件指出，工作區索引位於各自的 Derived Data 目錄；Xcode 版本說明也曾建議在部分建置問題發生時，清除該專案的 Derived Data 作為排除方式。換句話說，這個資料夾的內容原本就應該能夠重新產生，而不是原始碼的唯一來源。

遇到下列情況時，可以考慮清除：

不要只因為 Derived Data 存在就定期清空。開發中的專案會利用增量建置資料縮短編譯時間；若資料夾不大、運作也正常，刪除它只會用建置時間交換少量磁碟空間。

位置	建議	刪除後的影響
`~/Library/Developer/Xcode/DerivedData/ProjectName-*`	可刪除你能確認的單一專案資料	該專案需要重新建置與建立索引
`~/Library/Developer/Xcode/DerivedData` 內的所有內容	需要完整重設時可以清除	所有 Xcode 專案都需要重新建置與建立索引
`~/Library/Developer/Xcode/Archives`	不要當成快取刪除	可能失去用於發佈或當機分析的封存檔，以及對應的除錯符號
`~/Library/Developer/CoreSimulator/Devices`	請另外逐項檢查	可能失去模擬器中的應用程式、設定與測試資料
Git 儲存庫或專案資料夾	不要刪除	這裡才是實際的原始碼與專案設定

清除前也請先查看 Xcode 的 Settings → Locations。如果 Derived Data 設為 Custom，請使用畫面上顯示的位置，不要直接套用預設路徑。

如果想在刪除前先看清楚各個專案資料夾，使用 Finder 最直觀。

先移到垃圾桶，可以保留短暫的復原機會。確認專案能正常開啟並重新建置後，再清空垃圾桶。

先確認資料夾及其佔用的總空間：

du -sh "$HOME/Library/Developer/Xcode/DerivedData"
du -sh "$HOME/Library/Developer/Xcode/DerivedData"/* 2>/dev/null | sort -h

每個專案資料夾通常會以可辨識的專案名稱開頭，後面接著一段唯一識別字串。可以先在 Finder 中開啟檢查：

open "$HOME/Library/Developer/Xcode/DerivedData"

若要永久刪除單一專案，請將範例資料夾名稱換成你在輸出結果中看到的完整名稱：

rm -rf "$HOME/Library/Developer/Xcode/DerivedData/YourProject-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

若要永久刪除預設 Derived Data 資料夾內的所有項目：

find "$HOME/Library/Developer/Xcode/DerivedData" \
  -mindepth 1 -maxdepth 1 -exec rm -rf {} +

這些指令不會經過垃圾桶。按下 Return 前，務必再看一次完整路徑；如果 Xcode 正在建置、測試或建立索引，請不要執行最後一段指令。

如果只有一個專案出現建置問題，且不需要連同索引及其他工作區資料一起刪除，可以先在 Xcode 中執行 Product → Clean Build Folder。Apple 也將這個操作列為疑難排解方式之一。

工作區對應的指令可能如下：

xcodebuild \
  -workspace YourApp.xcworkspace \
  -scheme YourApp \
  clean

這個做法的範圍比刪除整個 Derived Data 資料夾小。它只會要求目前選取的建置系統清除該專案的建置成果，不是針對所有 Xcode 工作區的磁碟清理指令。

第一次建置通常會比較慢。Xcode 必須重新建置各個 target、建立索引，還可能需要再次解析或下載 Package 資料。在索引完成前，程式碼自動完成與跳至定義也可能暫時不完整。

專案檔案、Git 歷史記錄、簽署憑證、Provisioning Profile 和 Xcode Archives 都不在預設的 Derived Data 根目錄中。只刪除本文說明的確切路徑，就不會影響這些內容。

如果完整重建後原本的錯誤再次出現，問題根源很可能不是 Derived Data。此時應查看第一個有意義的編譯錯誤、套件相依性解析、目前使用的 Xcode 版本與專案 Build Settings，而不是反覆清除快取。