是的,很安全。~/Library/Developer/Xcode/DerivedData 存放的是建置輸出:編譯後的檔案、索引、日誌和中間產物。其中沒有任何你的代碼,下次你打開或建置項目時,Xcode 會重新建立它需要的一切。刪除它的代價是每個項目一次較慢的建置,而不是資料。
本指南介紹其中有什麼、什麼時候值得刪除、三種刪除方法,以及其他同樣會變得很大的 Xcode 資料夾。
什麼是 DerivedData
每次 Xcode 建置項目時,都會把結果寫到項目資料夾以外的地方,讓你的原始碼保持乾淨。那個地方就是 DerivedData。每個項目在其中都有自己的資料夾,以項目名稱加上一個看似隨機的後綴命名,例如 MyApp-bxkqzfvhgmwtadfhtbtuyzthmdyk。
在每個項目資料夾中,你通常會找到:
- Build:編譯後的 App、框架和中間目標檔案。
- Index.noindex:代碼補全、跳轉到定義和搜尋背後的索引。
- Logs:建置、測試和執行日誌。
- SourcePackages:項目依賴的 Swift 包的檢出副本。
- ModuleCache.noindex(位於頂層):在項目之間共享的預編譯模塊。
它會變得多大?
這取決於你建置了多少項目以及項目有多大。單個 App 可能佔用幾 GB;一台在一兩年裡建置過很多項目的 Mac,這裡常常有幾十 GB。你已刪除或不再開發的項目的資料夾會永遠留著,因為 Xcode 從不刪除它們。
要查看大小,請打開 Finder,選取前往,前往檔案夾,輸入 ~/Library/Developer/Xcode/DerivedData 並按下 Return 鍵。然後對該資料夾使用檔案,取得資訊,或切換到列表顯示方式並開啟顯示方式,打開顯示方式選項,計算全部大小,一次算出每個項目資料夾的大小。
刪除後你會失去什麼
時間,而不是資料:
- 每個項目的下一次建置都是完整建置。大型項目可能需要幾分鐘,而增量建置只要幾秒。
- Xcode 會重新索引項目。打開後的幾分鐘內,代碼補全和搜尋會變慢或不完整。
- Swift 包會在下次建置時重新下載,因為它們的檢出副本存放在
SourcePackages中。這需要聯網。 - 舊的建置日誌會消失。如果你需要某次過去建置的日誌,請先拷貝出來。
你的原始碼、項目設定、簽名設定、方案和 Git 歷史都在你的項目資料夾中,而不在 DerivedData 中。它們都不會被動到。
什麼時候值得刪除
- 它變得很大,而你需要空間。
- 建置以莫名其妙的方式失敗:「No such module」、過期的 Swift 包錯誤、無法重新整理的預覽,或者代碼補全顯示你早已刪除的內容。一個全新的 DerivedData 能解決數量驚人的此類問題。
- 你不再開發的項目。它們的資料夾純屬浪費。你可以只刪除這些,保留其餘的。
- Xcode 大版本更新之後,舊的模塊快取不再與新的編譯器匹配時。
如果你只想修復一個項目,請先試試 Product, Clean Build Folder(Shift-Command-K)。它會清除該項目的建置產物,不會動索引或其他項目。
如何刪除 DerivedData
無論哪種方法,都要先結束 Xcode。正在執行的 Xcode 可能正在向該資料夾寫入內容,並會在你刪除時重新建立其中一部分。
在 Finder 中
- 在 Finder 中,選取前往,前往檔案夾,然後輸入
~/Library/Developer/Xcode/DerivedData。 - 選中其中的所有內容,或者只選你不再需要的項目的資料夾。
- 把它們移到垃圾桶,等你的項目重新建置成功後再清空垃圾桶。
透過 Xcode 的設定
打開 Xcode, Settings, Locations。在 Derived Data 下,路徑旁邊的小箭頭會在 Finder 中打開該資料夾,你可以按上面的方法刪除它。如果你的啟動磁碟較小,也可以在這裡把 DerivedData 移到別的位置,例如外接磁碟。
在終端機中
rm -rf ~/Library/Developer/Xcode/DerivedData/*
這會立即刪除,不會進入垃圾桶。請準確輸入,因為路徑寫錯時,rm -rf 會刪除該路徑指向的任何內容。
其他會不斷變大的 Xcode 資料夾
~/Library/Developer 下的大塊內容很少只有 DerivedData。下面是其中的其他內容,以及刪除每一項的代價。
| 資料夾 | 包含的內容 | 可以安全刪除嗎? |
|---|---|---|
Xcode/DerivedData | 建置輸出和索引 | 可以。下次建置時會重建 |
Xcode/iOS DeviceSupport (還有 watchOS、tvOS) | 從你連接過的每台裝置和每個系統版本拷貝來的除錯符號 | 舊系統版本的可以。下次連接該裝置時會再次拷貝 |
Xcode/Archives | 你為 TestFlight 或 App Store 封存的每個建置版本,以及它們的除錯符號 | 已發佈的版本請保留。它們的符號能把崩潰報告變成可讀的調用棧 |
CoreSimulator/Devices | 你建立的每個模擬器,以及其中的 App 和資料 | 舊的可以。請使用下面的命令,而不是 Finder |
CoreSimulator/Caches | 模擬器的快取 | 可以。需要時會重建 |
| 模擬器執行環境 | 模擬器使用的完整 iOS、watchOS 和 visionOS 版本,每個通常有好幾 GB | 舊的可以。請在 Xcode 的設定中移除 |
模擬器
你已不再安裝的 iOS 版本對應的模擬器會以「不可用」狀態留下來。這條命令只移除這些模擬器:
xcrun simctl delete unavailable
要移除整個模擬器執行環境,請打開 Xcode, Settings, Components(在 Xcode 15 中叫 Platforms),選擇一個舊的執行環境並將其移除。
Swift 軟體包和其他開發者快取
~/Library/Caches/org.swift.swiftpm 存放項目之間共享的已下載 Swift 軟體包。可以安全清除,需要時軟體包會重新下載。如果你還使用 CocoaPods、Carthage、Homebrew、npm 或 Docker,它們各自都有快取,而且可能比 Xcode 的還大。
如何避免它再次變大
- 每隔幾個月刪除一次已完成或已放棄項目的 DerivedData 資料夾。
- 每次更新 Xcode 後執行
xcrun simctl delete unavailable。 - 移除你不再測試的系統版本的模擬器執行環境。
- 如果磁碟空間緊張,可以在 Settings, Locations 中把 DerivedData 移到外接 SSD。
常見問題
刪除 DerivedData 會刪除我的代碼嗎?不會。你的代碼和項目檔案都在你的項目資料夾中。DerivedData 只存放 Xcode 根據它們生成的內容。
會破壞我的 Git 儲存庫嗎?不會。Git 不跟蹤 DerivedData,其中的任何內容都不屬於你的儲存庫。
需要經常刪除嗎?不需要。在它很大、建置行為異常時,或者對已完成的項目刪除即可。每天刪除只會浪費你的建置時間。
Xcode 打開時可以刪除嗎?請先結束 Xcode。在 Xcode 執行環境刪除,可能會留下寫了一半的索引,並在重啟 Xcode 之前出現奇怪的錯誤。
DiskAtlas 和 Kempt 能幫上什麼

DiskAtlas 在一張地圖中顯示 DerivedData 以及 ~/Library/Developer 下每個資料夾的大小,並給每個資料夾加上標籤:會自動重建的建置輸出、會重新下載的內容,或者你自己的檔案。Kempt 的清理功能有一個「開發者」類別,專門針對 Xcode 的建置輸出和快取,給每一項加上標籤(會自動重建、會重新下載、先看一下或你的檔案),並且只把你勾選的內容移到垃圾桶,所以任何東西都可以放回原處。
Mac 上的其他部分,請參閱Mac 上哪些內容可以安全刪除和如何釋放磁碟空間。