블로그로 돌아가기

Mac에서 SwiftPM 캐시를 지워도 안전한가요?

~/Library/Caches/org.swift.swiftpm에 무엇이 있는지, 바이너리 아티팩트가 왜 크기를 키우는지, 지우면 어떻게 되는지, Xcode를 망가뜨리지 않고 비우는 방법.

게시됨 2026년 10월 25일 작성자 Vladimir Chemeris 읽는 시간 읽는 데 3분
SwiftSwiftPMDeveloper Cleanup

SwiftPM 캐시는 지워도 안전합니다. Swift Package Manager는 ~/Library/Caches/org.swift.swiftpm의 모든 파일을 다음 resolve 때 다시 만듭니다. 치르는 대가는 다운로드입니다. 제 Mac에서는 폴더 5.4 GB 가운데 4.7 GB가 바이너리 프레임워크였고, 그 전부를 다시 내려받아야 합니다.

기본 원칙: 먼저 Xcode를 종료하고, 공간이 필요할 때는 artifacts 폴더를 비우세요. 용량 대부분이 여기에 있고, 필요할 때 다시 생깁니다.

빠른 요약

  1. du -sh ~/Library/Caches/org.swift.swiftpm/*로 크기를 잽니다.
  2. Xcode를 종료하고 실행 중인 swift build를 멈춥니다.
  3. artifacts나 폴더 전체를 휴지통으로 옮깁니다.
  4. 프로젝트를 다시 열고 패키지 resolve가 끝나기를 기다립니다.
  5. 첫 resolve는 다운로드에 한동안 시간이 걸린다고 예상합니다.
  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 clone469 MB, 23개
manifestsPackage.swift를 평가한 결과의 캐시256 MB
prebuilts미리 빌드된 바이너리19 MB

폴더 이름은 ~/Library/Caches의 번들 식별자 규칙을 따릅니다. 그래서 Xcode의 나머지 저장 공간이 있는 ~/Library/Developer가 아니라, 앱 캐시들 옆에서 찾을 수 있습니다.

바이너리 아티팩트가 공간 대부분을 차지하는 이유

패키지는 프레임워크를 소스 코드 대신 미리 빌드된 .xcframework로 배포할 수 있습니다. SwiftPM은 그 zip을 내려받아 artifacts에 두며, 릴리스와 변형마다 항목이 하나씩 생깁니다.

제 Mac에서는 아티팩트 46개 중 45개가 sentry-cocoa라는 SDK 하나에서 왔습니다. 9.5.1부터 9.31.0까지 릴리스 일곱 개가 나란히 있었고, 릴리스마다 정적, 동적, UIKit이나 AppKit을 뺀 버전, arm64e를 포함한 버전 같은 변형이 여러 개 붙어 있었습니다. 모두 합쳐 4.7 GB였습니다. 그 옆의 소스 저장소 23개는 469 MB였습니다.

캐시에 어떤 릴리스가 있는지는 이렇게 확인합니다.

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

항목 이름에 다운로드 URL이 들어 있어서 SDK와 버전을 바로 읽을 수 있습니다.

지우면 어떻게 되나요

  • 다음 resolve가 다시 내려받습니다. Xcode에서 프로젝트를 열거나 swift package resolve, swift build를 실행하면 필요한 저장소를 clone하고 아티팩트를 내려받습니다. 연결이 느리다면 시간을 넉넉히 잡으세요.
  • 버전은 그대로입니다. 프로젝트마다 Package.resolved가 버전을 고정하고, resolve는 그 고정값을 씁니다.
  • 오프라인에서는 resolve가 실패합니다. 패키지 호스트에 다시 접속되면 프로젝트도 다시 빌드됩니다.
  • 프로젝트별 사본은 남습니다. 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.”(전역 저장소 캐시 비우기)라고 설명합니다. 실행한 뒤 폴더 크기를 다시 재서 무엇이 지워졌는지 확인하세요.

프로젝트가 다시 resolve되고 빌드되는 것을 확인한 뒤 휴지통을 비우세요.

핵심 요약

SwiftPM 캐시를 지워도 깨지는 것은 없지만, 바이너리 프레임워크가 대부분을 차지한다면 다시 채우는 데 긴 다운로드가 필요합니다. Xcode를 종료하고, artifacts 안을 살펴보고, 프로젝트가 더 이상 고정하지 않는 릴리스를 덜어 내세요. 폴더 전체는 다운로드를 감당할 수 있을 때만 비우세요.

저자 소개

Vladimir Chemeris

StorageRadar 창립자

Vladimir Chemeris는 프라이버시 우선 macOS 저장 공간 분석 앱 StorageRadar를 만듭니다. 검토 후 정리, 개발자 저장 공간, 전후 비교에 집중합니다.

자주 묻는 질문

~/Library/Caches/org.swift.swiftpm을 지워도 안전한가요?

안전합니다. 그 안의 모든 것은 다음 패키지 resolve 때 다시 생깁니다. 대가는 다운로드입니다. 패키지 저장소를 다시 clone하고 바이너리 프레임워크를 다시 내려받아야 하며, 그 양이 수 GB에 이를 수 있습니다.

SwiftPM 캐시를 지우면 패키지 버전이 바뀌나요?

아닙니다. 프로젝트마다 Package.resolved 파일이 그대로 남아 있으므로, 다음 resolve는 고정해 둔 것과 같은 버전을 가져옵니다.

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 명령을 멈추세요. 캐시가 사라지는 동안 돌던 resolve는 중간에 실패할 수 있고, 그러면 따로 정리해야 할 패키지 오류가 남습니다.

출처 및 참고자료

공간을 실제로 차지하는 패키지 캐시가 어느 것인지 확인하세요.

StorageRadar의 Dev Cleanup은 SwiftPM, npm, pnpm, Yarn, pip, Homebrew 캐시의 크기를 Xcode 폴더 옆에 보여 주고, 각각에 위험도 라벨을 붙이며, 정리 전에 Dry Run 결과를 보여 줍니다.