早鳥優惠:我們出品的每一款 App,永久更新,只需一次性付款 $25。僅限前 50 位買家查看優惠
繁體中文

指南

刪除 Xcode DerivedData 安全嗎?安全,以及具體方法

更新於 2026 年 10 月 27 日

是的,很安全。~/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 中

  1. 在 Finder 中,選取前往,前往檔案夾,然後輸入 ~/Library/Developer/Xcode/DerivedData。
  2. 選中其中的所有內容,或者只選你不再需要的項目的資料夾。
  3. 把它們移到垃圾桶,等你的項目重新建置成功後再清空垃圾桶。

透過 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 中 Developer 資料夾的詳情面板:28.4 GB,標記為「可重新生成」,Xcode 會在你下次建置時重建它
DiskAtlas 將 Developer 資料夾標記為「可重新生成」:Xcode 會在你下次建置時重建它。

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

Mac 上的其他部分,請參閱Mac 上哪些內容可以安全刪除和如何釋放磁碟空間。