Xcode磁盘空间占用过高主要源于衍生数据、模拟器快照、模块缓存、索引文件等,可通过清理Derived Data、模块缓存、旧模拟器、文档缓存及扫描大文件五步解决。

如果您在使用Xcode进行iOS或macOS开发时发现磁盘空间被大量占用,且无法通过常规方式释放,问题很可能源于Xcode生成的衍生数据(Derived Data)、模拟器快照、模块缓存、索引文件等。以下是清理Xcode衍生文件并分析开发空间占用的具体操作步骤:
一、删除Xcode衍生数据(Derived Data)
Derived Data是Xcode为每个项目生成的构建产物、编译中间文件、符号索引、调试信息等集合,默认存储于用户目录下。这些文件体积庞大且长期积累后可达数十GB,但可安全删除,Xcode会在下次构建时自动重建。
1、打开Xcode,点击顶部菜单栏Xcode → Preferences…。
2、在弹出窗口中切换至Locations标签页。
3、在Derived Data右侧点击箭头图标,快速定位到该路径(通常为~/Library/Developer/Xcode/DerivedData)。
4、关闭Xcode,在Finder中进入该文件夹,全选所有子文件夹与文件,执行Command + Delete彻底移入废纸篓。
5、清空废纸篓以释放磁盘空间。
二、清除Xcode模块缓存与索引数据库
Xcode会为Swift和Objective-C项目维护模块接口缓存(Module Cache)及源代码索引(Index Database),用于加速代码补全与跳转,但缓存文件可能损坏或膨胀,需手动清理。
1、退出Xcode。
2、在终端中依次执行以下命令:
rm -rf ~/Library/Developer/Xcode/DerivedData/*
rm -rf ~/Library/Caches/com.apple.dt.Xcode
rm -rf ~/Library/Developer/Xcode/Archives
rm -rf ~/Library/Developer/Xcode/iOS Device Logs
3、重启Xcode,首次打开项目时将重新生成必要缓存。
三、卸载未使用的模拟器运行时与设备
每次安装新版本Xcode或通过Components下载模拟器运行时(Simulator Runtimes)和设备(Simulator Devices),都会在~/Library/Developer/CoreSimulator中占用数GB空间。保留仅当前开发所需的运行时即可。
1、打开Xcode,点击Xcode → Settings…(或Preferences…),进入Platforms标签页。
2、查看已安装的Simulator Runtimes列表,勾选不再支持的旧版本(如iOS 14.0、watchOS 7.0等)。
3、点击右下角-(减号)按钮将其卸载。
4、同步进入Devices and Simulators(Shift + Command + 2),在Simulators标签页中,选中长期未用的自定义模拟器设备,点击下方Delete键移除。
四、清理Xcode自带的文档与帮助缓存
Xcode内置的API文档、语言参考、WWDC视频摘要等内容默认会随更新自动下载并缓存,若未主动禁用,可能累积数GB本地副本。
1、打开Xcode,进入Xcode → Settings… → Documentation。
2、在左侧列表中,取消勾选所有已下载但不再查阅的文档集(如“Swift Standard Library”、“iOS 17.0 Documentation”等)。
3、选中某项后,点击右侧Remove按钮逐个清除。
4、确认删除后,对应缓存文件将从~/Library/Developer/Shared/Documentation中移除。
五、扫描并识别Xcode相关大文件与残留目录
部分Xcode插件、第三方工具链(如Carthage、CocoaPods构建产物)、或误存于Xcode目录下的临时工程备份,可能未被上述流程覆盖。需借助系统级路径排查。
1、在终端中运行以下命令,列出Xcode主目录下大于500MB的文件:
find ~/Library/Developer/Xcode -type f -size +500M -ls 2>/dev/null | sort -k7nr | head -20
2、检查输出结果中的路径,重点关注DerivedData外的异常大文件,例如~/Library/Developer/Xcode/UserData/FontAndColorThemes/中冗余主题包,或~/Library/Developer/Xcode/Templates/中废弃模板。
3、对确认无用的大文件,使用rm命令直接删除;对整个可疑目录,先压缩备份再删除。










