开发者存储指南

如何安全清理 Xcode DerivedData

DerivedData 包含可重新生成的索引和构建产物,因此在 Xcode 及相关工具停止使用后,通常可以移除过期的项目文件夹。删除会让后续索引和构建重新进行;不要把 DerivedData 与源代码仓库或 Xcode Archives 混淆。

macOS 自带方法

如果只有一个 workspace 出现问题,请针对该项目清理;只有在审核过时间与大小后,才执行更广泛的清理。

  1. 完成当前构建,退出依赖相关产物的 Xcode 和模拟器,并单独提交或备份源代码工作。
  2. 从 Xcode 设置或 Finder 打开 DerivedData 位置,检查文件夹名称、修改日期和大小。
  3. 只把过期的项目文件夹移入废纸篓。不要把 Archives 和源代码仓库包含在选择范围中。
  4. 重新打开活跃项目;在清空废纸篓前,预留时间让 Xcode 重新索引并构建。

什么时候适合使用 Mint

当多个 Xcode 项目积累了构建产物,而你希望与其他开发者产物一起审核候选内容时,Mint 会更有帮助。

  • 扫描支持的开发者位置,结合路径、大小和时间信息展示 DerivedData。
  • 移除前逐项审核候选内容,而不是盲目删除整个上级目录。
  • 执行可用的 Xcode DerivedData 清理规则前,先通过 dry run 查看结果。
  • 把批准的产物移入废纸篓,并在本机操作日志中记录批次。

边界与安全检查

DerivedData 可以重建,但移除它会消耗时间,也可能打断正在进行的工作。

  • 不要移除正在被构建、测试、预览或调试会话使用的产物。
  • Xcode Archives 属于不同内容,可能包含唯一保留、可用于导出或符号化的构建。
  • 清空废纸篓前,成功重新构建是最可靠的确认方式;Undo 仍取决于废纸篓中的项目是否存在。

常见问题

Xcode DerivedData 可以安全删除吗?

它可以重建,但删除会移除索引和构建产物,并可能让下一次构建变慢。请先停止活跃的 Xcode 工作,并审核项目级文件夹。

清理 DerivedData 会删除源代码吗?

如果选择范围确实位于 DerivedData 内,就不会。请确认准确路径,并把源代码仓库与 Archives 排除在清理列表外。

Mint 能查找其他开发者产物吗?

Mint 可以在支持的位置扫描开发者产物,包括 DerivedData、模拟器数据、包管理器缓存和过期 node_modules;具体受版本权限和你的审核决定约束。

按项目审核过期 DerivedData

扫描开发产物,只选择确认不用的项目目录。

扫描开发产物