ブログに戻る

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 日に、Swift 6.4 と Xcode 27.1 を入れた私の Mac でキャッシュを測りました。

サブフォルダー中身私の Mac では
artifactsダウンロードしたバイナリターゲット、zip にした .xcframework ファイル4.7 GB、46 項目
repositoriesパッケージリポジトリの git クローン469 MB、23 項目
manifestsPackage.swift を評価した結果のキャッシュ256 MB
prebuiltsビルド済みのバイナリ19 MB

フォルダー名は ~/Library/Caches で使われるバンドル ID 形式の命名に従っています。そのため、Xcode のほかのストレージがある ~/Library/Developer ではなく、アプリのキャッシュと並んで見つかります。

バイナリアーティファクトが容量の大半を占める理由

パッケージは、フレームワークをソースコードではなくビルド済みの .xcframework として配布できます。SwiftPM はその zip をダウンロードして artifacts に保存し、リリースとバリアントごとに 1 エントリーずつ持ちます。

私の Mac では、46 個のアーティファクトのうち 45 個が 1 つの SDK、sentry-cocoa のものでした。9.5.1 から 9.31.0 まで 7 つのリリースが並び、各リリースにはいくつものバリアントがありました。static、dynamic、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 では 1 つのプロジェクトのコピーが 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 は、プライバシー重視の macOS ストレージ分析アプリ StorageRadar を開発しています。確認してから削除する流れ、開発者向けストレージ、前後比較を重視しています。

よくある質問

~/Library/Caches/org.swift.swiftpm は削除しても安全ですか?

安全です。中身はすべて、次のパッケージ解決で戻ってきます。代償はダウンロードです。パッケージのリポジトリはもう一度クローンされ、バイナリフレームワークはもう一度ダウンロードされます。合わせて数 GB になることもあります。

SwiftPM のキャッシュを削除すると、パッケージのバージョンは変わりますか?

変わりません。プロジェクトには Package.resolved ファイルが残るので、次の解決では固定していたのと同じバージョンを取得します。

SwiftPM のキャッシュはなぜこんなに大きいのですか?

バイナリアーティファクトのせいです。xcframework で配布される SDK はリリースとバリアントごとに zip を 1 つ保存し、キャッシュは古いリリースを新しいものと並べて残します。私の Mac では 46 個のアーティファクトのうち 45 個が 1 つの 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 の結果を見せます。