Apagar o cache do SwiftPM é seguro: o Swift Package Manager reconstrói todos os arquivos de ~/Library/Caches/org.swift.swiftpm na próxima resolução de pacotes. O preço é o download. No meu Mac, 4,7 GB dos 5,4 GB da pasta eram frameworks binários, e todos eles seriam baixados de novo.
Regra principal: feche o Xcode antes e limpe a pasta artifacts quando precisar do espaço. Ela concentra a maior parte do tamanho e volta sob demanda.
Resposta rápida
- Meça com
du -sh ~/Library/Caches/org.swift.swiftpm/*. - Feche o Xcode e pare qualquer
swift buildem execução. - Mova
artifacts, ou a pasta inteira, para o Lixo. - Abra o projeto de novo e deixe-o resolver os pacotes.
- Conte com a primeira resolução baixando arquivos por um bom tempo.
- Se o Xcode mostrar erros de pacote depois, rode File, Packages, Reset Package Caches.
O que fica na pasta
Medi o cache em 25 de outubro de 2026 no meu Mac, com Swift 6.4 e Xcode 27.1:
| Subpasta | O que guarda | No meu Mac |
|---|---|---|
artifacts | targets binários baixados, arquivos .xcframework compactados em zip | 4,7 GB, 46 itens |
repositories | clones git dos repositórios de pacotes | 469 MB, 23 itens |
manifests | resultados em cache da avaliação do Package.swift | 256 MB |
prebuilts | binários pré-compilados | 19 MB |
O nome da pasta segue a convenção de bundle identifier de ~/Library/Caches, por isso ela fica ao lado dos caches de apps, e não em ~/Library/Developer com o resto do armazenamento do Xcode.
Por que os artefatos binários ocupam a maior parte do espaço
Um pacote pode distribuir um framework como .xcframework pré-compilado em vez de código-fonte. O SwiftPM baixa o zip e o guarda em artifacts, uma entrada por release e variante.
No meu Mac, 45 dos 46 artefatos vinham de um único SDK, o sentry-cocoa. Sete releases conviviam lado a lado, da 9.5.1 à 9.31.0, e cada release somava várias variantes: estática, dinâmica, sem UIKit ou AppKit, com arm64e. Juntas, ocupavam 4,7 GB. Os 23 repositórios de código-fonte ao lado delas ocupavam 469 MB.
Rode isto para ver quais releases o seu cache guarda:
ls ~/Library/Caches/org.swift.swiftpm/artifacts
Os nomes das entradas contêm a URL de download, então dá para ler o SDK e a versão.
O que acontece depois de apagar
- A próxima resolução baixa tudo de novo. Abrir um projeto no Xcode, rodar
swift package resolveouswift buildclona os repositórios e baixa os artefatos necessários. Numa conexão lenta, reserve tempo para isso. - Suas versões continuam as mesmas. O
Package.resolvedde cada projeto fixa as versões, e a resolução usa essas versões fixadas. - Offline, a resolução falha. Os projetos voltam a compilar assim que os hosts dos pacotes ficam acessíveis.
- As cópias por projeto ficam. O Xcode mantém os checkouts de cada projeto no DerivedData, numa pasta
SourcePackagesdentro da pasta do projeto. No meu Mac, a cópia de um projeto ocupava 240 MB. Apagar o cache global não mexe nela; apagar o DerivedData, sim.
Como limpar
Só as releases antigas. Compare as versões nos nomes dentro de artifacts com os arquivos Package.resolved dos projetos em que você trabalha e mova as entradas mais antigas para o Lixo. Você mantém os downloads atuais e se livra do peso morto.
A pasta artifacts inteira. Feche o Xcode e mova ~/Library/Caches/org.swift.swiftpm/artifacts para o Lixo. É o que libera mais espaço com menos código-fonte para baixar de novo.
O cache inteiro. Mova ~/Library/Caches/org.swift.swiftpm para o Lixo ou rode swift package purge-cache. O texto de ajuda descreve o comando como “Purge the global repository cache.” (limpa o cache global de repositórios). Meça a pasta depois para ver o que ele removeu.
Esvazie o Lixo quando seus projetos voltarem a resolver os pacotes e a compilar.
Conclusão
Apagar o cache do SwiftPM não quebra nada, e reabastecê-lo custa um download longo quando frameworks binários dominam a pasta. Feche o Xcode, olhe dentro de artifacts, descarte as releases que seus projetos não fixam mais e limpe a pasta inteira só quando puder arcar com o download.
Perguntas frequentes
É seguro apagar ~/Library/Caches/org.swift.swiftpm?
Sim. Tudo o que está ali volta na próxima resolução de pacotes. O custo é o download: os repositórios dos pacotes são clonados de novo e os frameworks binários são baixados outra vez, o que pode significar vários gigabytes.
Apagar o cache do SwiftPM muda as versões dos meus pacotes?
Não. Seus projetos mantêm os arquivos Package.resolved, então a próxima resolução busca as mesmas versões que estavam fixadas.
Por que o meu cache do SwiftPM é tão grande?
Por causa dos artefatos binários. SDKs distribuídos como xcframeworks guardam um zip por release e variante, e o cache mantém as releases antigas ao lado das novas. No meu Mac, 45 de 46 artefatos vinham de um único SDK e ocupavam 4,7 dos 5,4 GB da pasta.
É a mesma coisa que o SourcePackages no DerivedData?
Não. O Xcode mantém uma cópia por projeto dos pacotes em checkout no DerivedData, numa pasta SourcePackages dentro da pasta de cada projeto. Apagar o DerivedData remove essa cópia. Apagar o cache global do SwiftPM a deixa onde está.
Posso apagar o cache do SwiftPM com o Xcode aberto?
Feche o Xcode e pare antes qualquer comando swift build ou swift package. Uma resolução que roda enquanto o cache dela desaparece pode falhar no meio do caminho e deixar erros de pacote para você resolver.