是的,很安全。~/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 可能正在向该文件夹写入内容,并会在你删除时重新创建其中一部分。
在访达中
- 在访达中,选取前往,前往文件夹,然后输入
~/Library/Developer/Xcode/DerivedData。 - 选中其中的所有内容,或者只选你不再需要的项目的文件夹。
- 把它们移到废纸篓,等你的项目重新构建成功后再清倒废纸篓。
通过 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 在一张地图中显示 DerivedData 以及 ~/Library/Developer 下每个文件夹的大小,并给每个文件夹加上标签:会自动重建的构建输出、会重新下载的内容,或者你自己的文件。Kempt 的清理功能有一个“开发者”类别,专门针对 Xcode 的构建输出和缓存,给每一项加上标签(会自动重建、会重新下载、先看一下或你的文件),并且只把你勾选的内容移到废纸篓,所以任何东西都可以放回原处。
Mac 上的其他部分,请参阅Mac 上哪些内容可以安全删除和如何释放磁盘空间。