清理Xcode Derived Data可快速释放数十GB空间,分一键清空全部或精准删除当前项目子目录两种方式,操作前须关闭Xcode,清理后需执行Clean Build Folder重建缓存。

Mac终端清理Xcode的Derived Data是释放数十GB硬盘空间最高效的方式,尤其适合编译卡顿、索引失效或磁盘“其他”类目异常膨胀时快速执行,全程无需打开图形界面,30秒内完成。
用终端命令一键清空全部DerivedData
这一步直接递归删除整个DerivedData目录,适用于硬盘告急、准备重装环境或确认所有项目缓存均已废弃的场景。操作前必须关闭Xcode,否则部分文件被xcodebuild进程锁定,【rm -rf命令将跳过被锁文件但不报错,导致清理不彻底】。
打开“终端”(应用程序 → 实用工具),粘贴并执行以下命令:
rm -rf ~/Library/Developer/Xcode/DerivedData
执行后无任何输出即表示成功。如需验证是否清空,可运行:
ls -la ~/Library/Developer/Xcode/ | grep DerivedData
若返回空结果,说明DerivedData文件夹已不存在。
精准清理当前项目的DerivedData子目录
如果你只想清理正在开发的项目缓存,又不想影响其他项目(比如团队协作中多个分支共存),就不能删整个DerivedData文件夹——Xcode为每个项目生成唯一命名的子目录,形如“MyApp-abc123xyz”,需先定位再删除。
第一步:确保Xcode已启动,并打开你要处理的项目。
第二步:在终端中执行以下命令,自动获取当前项目对应的DerivedData子目录路径:
defaults read com.apple.dt.Xcode IDEApplicationwideBuildSettings | grep -A 1 "derivedDataPath" | tail -n 1 | sed 's/^[[:space:]]*//; s/[[:space:]]*$//'
第三步:复制上一步输出的完整路径(通常以~/Library/Developer/Xcode/DerivedData/开头),在终端中执行:
rm -rf 【粘贴你刚复制的完整路径】
注意:不要手动拼接路径,Xcode可能启用了自定义DerivedData位置,硬编码路径会导致删错目录。
清理后重建缓存的必要操作
删除完成后,Xcode不会自动重建缓存——它只在你真正触发构建动作时才开始生成。因此必须手动执行一次Clean Build Folder,否则后续编译仍可能报“Module not found”或补全失效。
重新打开Xcode → 打开对应项目 → 顶部菜单栏选择Product → Clean Build Folder(快捷键Shift + Command + K)。
这一步会强制Xcode扫描源码、重建索引和模块缓存,首次构建会略慢,属正常现象。

















