Voltar ao blog

É seguro apagar o cache do SwiftPM no Mac?

O que ~/Library/Caches/org.swift.swiftpm guarda, por que os artefatos binários o deixam grande, o que acontece ao apagá-lo e como limpar sem quebrar o Xcode.

Publicado 25 de outubro de 2026 Autor Vladimir Chemeris Tempo de leitura 4 min de leitura
SwiftSwiftPMDeveloper Cleanup

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

  1. Meça com du -sh ~/Library/Caches/org.swift.swiftpm/*.
  2. Feche o Xcode e pare qualquer swift build em execução.
  3. Mova artifacts, ou a pasta inteira, para o Lixo.
  4. Abra o projeto de novo e deixe-o resolver os pacotes.
  5. Conte com a primeira resolução baixando arquivos por um bom tempo.
  6. 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:

SubpastaO que guardaNo meu Mac
artifactstargets binários baixados, arquivos .xcframework compactados em zip4,7 GB, 46 itens
repositoriesclones git dos repositórios de pacotes469 MB, 23 itens
manifestsresultados em cache da avaliação do Package.swift256 MB
prebuiltsbinários pré-compilados19 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 resolve ou swift build clona 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.resolved de 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 SourcePackages dentro 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.

Sobre o autor

Vladimir Chemeris

Fundador, StorageRadar

Vladimir Chemeris desenvolve o StorageRadar, um app de macOS para análise de armazenamento com foco em privacidade, limpeza com revisão prévia, armazenamento de desenvolvedor e comparação antes e depois.

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.

Fontes e referências

Veja qual cache de pacotes realmente ocupa o espaço.

O Dev Cleanup do StorageRadar mede os caches do SwiftPM, npm, pnpm, Yarn, pip e Homebrew ao lado das pastas do Xcode, classifica cada um por risco e mostra o resultado de um Dry Run antes da limpeza.