返回博客

Mac 上的 SwiftPM 缓存可以删除吗

~/Library/Caches/org.swift.swiftpm 里装了什么,二进制产物为什么让它变得这么大,删除之后会发生什么,以及如何清理而不弄坏 Xcode。

已发表 2026年10月25日 作者 Vladimir Chemeris 阅读时间 约 1 分钟阅读
SwiftSwiftPMDeveloper Cleanup

删除 SwiftPM 缓存是安全的:下一次解析时,Swift Package Manager 会把 ~/Library/Caches/org.swift.swiftpm 里的每个文件重新建出来。你要付出的是下载。在我的 Mac 上,这个文件夹 5.4 GB 中有 4.7 GB 是二进制框架,每一个都得重新下载。

基本原则:先退出 Xcode;需要空间时清掉 artifacts 文件夹。大部分体积都在它身上,需要时会自动回来。

快速回答

  1. 用 du -sh ~/Library/Caches/org.swift.swiftpm/* 量一量。
  2. 退出 Xcode,停掉所有正在运行的 swift build。
  3. 把 artifacts 或整个文件夹移入废纸篓。
  4. 重新打开项目,让它解析包。
  5. 做好第一次解析要下载一阵子的准备。
  6. 如果之后 Xcode 报包错误,执行 File、Packages、Reset Package Caches。

文件夹里有什么

我在 2026 年 10 月 25 日量了自己 Mac 上的这个缓存,环境是 Swift 6.4 和 Xcode 27.1:

子文件夹存放内容在我的 Mac 上
artifacts下载的二进制 target,即打成 zip 的 .xcframework 文件4.7 GB,46 项
repositories包仓库的 git 克隆469 MB,23 项
manifests对 Package.swift 求值后缓存的结果256 MB
prebuilts预构建的二进制文件19 MB

这个文件夹的命名遵循 ~/Library/Caches 里的 bundle identifier 惯例,所以它和各个应用的缓存放在一起,而不是和 Xcode 的其他存储一起待在 ~/Library/Developer 里。

为什么二进制产物占了大部分空间

一个包可以不提供源代码,而是以预构建的 .xcframework 形式发布框架。SwiftPM 会下载对应的 zip 并保存在 artifacts 里,每个版本、每个变体各占一项。

在我的 Mac 上,46 个产物中有 45 个来自同一个 SDK:sentry-cocoa。从 9.5.1 到 9.31.0,七个版本并排放着,每个版本又带来好几个变体:静态、动态、不含 UIKit 或 AppKit、带 arm64e。它们加起来占了 4.7 GB。旁边的 23 个源码仓库占 469 MB。

运行下面的命令,看看你的缓存里存着哪些版本:

ls ~/Library/Caches/org.swift.swiftpm/artifacts

条目名称里包含下载 URL,所以 SDK 和版本一眼就能看出来。

删除之后会发生什么

  • 下一次解析会重新下载。 在 Xcode 里打开项目、执行 swift package resolve 或 swift build,都会克隆仓库并下载所需的产物。网速慢的话,给它留出时间。
  • 版本保持不变。 每个项目的 Package.resolved 锁定了版本,解析时会按这些锁定来。
  • 离线时解析会失败。 等包的托管服务能访问了,项目就能再次构建。
  • 各项目的副本还在。 Xcode 会在 DerivedData 里为每个项目保留检出,放在项目文件夹内的 SourcePackages 文件夹里。在我的 Mac 上,一个项目的这份副本占 240 MB。删除全局缓存不会碰它,删除 DerivedData 则会。

如何清理

只清旧版本。 把 artifacts 条目名称里的版本号和你手头项目的 Package.resolved 文件对照一下,把较旧的条目移入废纸篓。当前用到的下载留着,多余的包袱扔掉。

整个 artifacts 文件夹。 退出 Xcode,然后把 ~/Library/Caches/org.swift.swiftpm/artifacts 移入废纸篓。这样释放的空间最多,需要重新下载的源代码最少。

整个缓存。 把 ~/Library/Caches/org.swift.swiftpm 移入废纸篓,或者运行 swift package purge-cache。它的帮助文本是这样描述的:“Purge the global repository cache.”(清除全局仓库缓存。)事后再量一次文件夹,看看它删掉了什么。

等项目重新解析、构建成功之后,再清空废纸篓。

总结

删除 SwiftPM 缓存不会弄坏任何东西;但如果里面主要是二进制框架,重新填满它就意味着一次漫长的下载。退出 Xcode,看看 artifacts 里有什么,扔掉项目不再锁定的版本,只有在你承担得起这次下载时才清空整个文件夹。

关于作者

Vladimir Chemeris

StorageRadar 创始人

Vladimir Chemeris 开发 StorageRadar,一款注重隐私的 macOS 存储分析应用,强调先审查后清理、开发者存储和前后对比。

常见问题

可以删除 ~/Library/Caches/org.swift.swiftpm 吗?

可以。里面的所有内容都会在下一次解析包时回来。代价是下载:包仓库要重新克隆,二进制框架要重新下载,可能是好几个 GB。

删除 SwiftPM 缓存会改变我的包版本吗?

不会。你的项目保留着各自的 Package.resolved 文件,所以下一次解析拉取的还是你锁定的那些版本。

我的 SwiftPM 缓存为什么这么大?

因为二进制产物。以 xcframework 形式发布的 SDK 每个版本、每个变体都存一个 zip,而缓存会把旧版本和新版本一起留着。在我的 Mac 上,46 个产物中有 45 个来自同一个 SDK,占了这个文件夹 5.4 GB 中的 4.7 GB。

这和 DerivedData 里的 SourcePackages 是一回事吗?

不是。Xcode 会在 DerivedData 里为每个项目保留一份检出的包,放在各个项目文件夹内的 SourcePackages 文件夹里。删除 DerivedData 会删掉这份副本,删除全局 SwiftPM 缓存则不会动它。

可以在 Xcode 开着的时候删除 SwiftPM 缓存吗?

先退出 Xcode,并停掉所有正在运行的 swift build 或 swift package 命令。如果缓存在解析过程中消失,解析可能中途失败,留下一堆需要你收拾的包错误。

来源和参考文献

看清到底是哪个包缓存占着空间。

StorageRadar 的 Dev Cleanup 把 SwiftPM、npm、pnpm、Yarn、pip 和 Homebrew 的缓存与 Xcode 的文件夹并排显示大小,按风险给每一项打上标签,并在清理之前展示 Dry Run 的结果。