早鸟优惠:我们出品的每一款 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 从不删除它们。

要查看大小,请打开访达,选取前往,前往文件夹,输入 ~/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 可能正在向该文件夹写入内容,并会在你删除时重新创建其中一部分。

在访达中

  1. 在访达中,选取前往,前往文件夹,然后输入 ~/Library/Developer/Xcode/DerivedData。
  2. 选中其中的所有内容,或者只选你不再需要的项目的文件夹。
  3. 把它们移到废纸篓,等你的项目重新构建成功后再清倒废纸篓。

通过 Xcode 的设置

打开 Xcode, Settings, Locations。在 Derived Data 下,路径旁边的小箭头会在访达中打开该文件夹,你可以按上面的方法删除它。如果你的启动磁盘较小,也可以在这里把 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 和数据旧的可以。请使用下面的命令,而不是访达
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 上哪些内容可以安全删除和如何释放磁盘空间。