Oferta para os primeiros compradores: todos os apps que fazemos, com atualizações para sempre, por $25 uma única vez. Limitada aos primeiros 50 compradoresVer a oferta
Português (Brasil)

Guias

É seguro apagar o DerivedData do Xcode? Sim, e veja como fazer

Atualizado em 27 de outubro de 2026

Sim, é seguro. O ~/Library/Developer/Xcode/DerivedData guarda a saída de build: arquivos compilados, índices, logs e produtos intermediários. Nada disso é seu código, e o Xcode recria tudo de que precisa da próxima vez que você abrir ou compilar um projeto. Apagá-lo custa um build mais lento por projeto, não dados.

Este guia explica o que tem dentro, quando vale a pena apagar, três jeitos de fazer isso e as outras pastas do Xcode que crescem tanto quanto.

O que é o DerivedData

Toda vez que o Xcode compila um projeto, ele grava os resultados fora da pasta do projeto, para que seu código-fonte fique limpo. Esse lugar é o DerivedData. Cada projeto ganha uma pasta própria lá dentro, com o nome do projeto mais um sufixo com cara de aleatório, por exemplo MyApp-bxkqzfvhgmwtadfhtbtuyzthmdyk.

Dentro da pasta de cada projeto você costuma encontrar:

  • Build: o app compilado, frameworks e arquivos objeto intermediários.
  • Index.noindex: o índice por trás do autocompletar, do ir para a definição e da busca.
  • Logs: logs de build, teste e execução.
  • SourcePackages: cópias dos pacotes Swift de que o projeto depende.
  • ModuleCache.noindex (no nível principal): módulos pré-compilados compartilhados entre projetos.

Até que tamanho ele chega?

Depende de quantos projetos você compila e do tamanho deles. Um único app pode usar alguns gigabytes; um Mac que compilou muitos projetos ao longo de um ou dois anos muitas vezes guarda dezenas de gigabytes aqui. Pastas de projetos que você apagou ou abandonou ficam para sempre, porque o Xcode nunca as remove.

Para ver o tamanho, abra o Finder, escolha Ir, Ir para a Pasta, digite ~/Library/Developer/Xcode/DerivedData e pressione Return. Depois use Arquivo, Obter Informações na pasta, ou mude para a visualização em lista e ative Visualizar, Mostrar Opções de Visualização, Calcular todos os tamanhos para ver o tamanho de cada pasta de projeto de uma vez.

O que você perde ao apagá-lo

Tempo, não dados:

  • O próximo build de cada projeto é um build limpo. Projetos grandes podem levar vários minutos onde um build incremental levava segundos.
  • O Xcode reindexa o projeto. Por alguns minutos depois de abri-lo, o autocompletar e a busca ficam mais lentos ou incompletos.
  • Os pacotes Swift são baixados de novo no próximo build, porque as cópias deles ficavam em SourcePackages. Isso precisa de rede.
  • Logs de builds antigos somem. Se precisar de um log de um build passado, copie-o antes.

Seu código-fonte, configurações do projeto, configurações de assinatura, esquemas e histórico do Git ficam todos na pasta do projeto, não no DerivedData. Nada disso é tocado.

Quando vale a pena apagar

  • Ele cresceu muito e você precisa do espaço.
  • Um build falha de um jeito que não faz sentido: “No such module”, erros de pacotes Swift desatualizados, prévias que não atualizam, ou um autocompletar que mostra coisas que você removeu há muito tempo. Um DerivedData novo resolve uma quantidade surpreendente desses casos.
  • Projetos em que você não trabalha mais. As pastas deles são puro desperdício. Você pode apagar só essas e manter o resto.
  • Depois de uma grande atualização do Xcode, quando caches de módulos antigos não combinam mais com o novo compilador.

Se você só quer consertar um projeto, tente primeiro Product, Clean Build Folder (Shift-Command-K). Isso limpa os produtos de build daquele projeto sem tocar no índice nem em outros projetos.

Como apagar o DerivedData

Em qualquer caso, encerre o Xcode primeiro. Um Xcode aberto pode estar gravando na pasta, e ele vai recriar partes dela enquanto você apaga.

No Finder

  1. No Finder, escolha Ir, Ir para a Pasta e digite ~/Library/Developer/Xcode/DerivedData.
  2. Selecione tudo lá dentro, ou só as pastas dos projetos de que você não precisa mais.
  3. Mova-as para a Lixeira, e esvazie-a quando seus projetos voltarem a compilar.

Pelos ajustes do Xcode

Abra Xcode, Settings, Locations. Em Derived Data, a pequena seta ao lado do caminho abre a pasta no Finder, onde você pode apagá-la como acima. É também aqui que você pode mover o DerivedData para outro lugar, como um disco externo, se o seu disco de inicialização for pequeno.

No Terminal

rm -rf ~/Library/Developer/Xcode/DerivedData/*

Isto apaga na hora; nada vai para a Lixeira. Digite exatamente assim, porque rm -rf com um caminho errado apaga o que esse caminho apontar.

As outras pastas do Xcode que crescem

O DerivedData raramente é a única coisa grande em ~/Library/Developer. Veja o que mais tem lá, e o que custa apagar cada um.

PastaO que guardaSeguro apagar?
Xcode/DerivedDataSaída de build e índicesSim. Recriado no próximo build
Xcode/iOS DeviceSupport (também watchOS, tvOS)Símbolos de depuração copiados de cada dispositivo e versão de sistema que você conectouSim para versões antigas do sistema. Copiados de novo na próxima vez que o dispositivo se conectar
Xcode/ArchivesCada build que você arquivou para o TestFlight ou a App Store, com os símbolos de depuraçãoMantenha os que você publicou. Os símbolos deles transformam relatórios de falhas em rastros de pilha legíveis
CoreSimulator/DevicesCada simulador que você criou, com seus apps e dadosOs antigos, sim. Use o comando abaixo em vez do Finder
CoreSimulator/CachesCaches dos simuladoresSim. Recriados quando necessário
Runtimes do simuladorVersões inteiras do iOS, watchOS e visionOS para o simulador, muitas vezes vários GB cadaOs antigos, sim. Remova-os nos ajustes do Xcode

Simuladores

Simuladores de versões do iOS que você não tem mais instaladas ficam para trás como “unavailable”. Este comando remove só esses:

xcrun simctl delete unavailable

Para remover um runtime inteiro do simulador, abra Xcode, Settings, Components (chamado Platforms no Xcode 15), selecione um runtime antigo e remova-o.

Pacotes Swift e outros caches de desenvolvimento

~/Library/Caches/org.swift.swiftpm guarda pacotes Swift baixados e compartilhados entre projetos. É seguro limpar; os pacotes são baixados de novo quando necessário. Se você também usa CocoaPods, Carthage, Homebrew, npm ou Docker, cada um guarda o próprio cache, e eles podem ser ainda maiores que o do Xcode.

Como evitar que ele cresça de novo

  • Apague as pastas DerivedData de projetos concluídos ou abandonados a cada poucos meses.
  • Rode xcrun simctl delete unavailable depois de cada atualização do Xcode.
  • Remova runtimes do simulador de versões do sistema que você não testa mais.
  • Se o espaço em disco estiver apertado, mova o DerivedData para um SSD externo em Settings, Locations.

Perguntas

Apagar o DerivedData apaga meu código? Não. Seu código e seus arquivos de projeto ficam na pasta do projeto. O DerivedData guarda só o que o Xcode gerou a partir deles.

Isso quebra meu repositório Git? Não. O Git não rastreia o DerivedData, e nada nele pertence ao seu repositório.

Preciso apagar com frequência? Não. Apague quando estiver grande, quando os builds agirem de forma estranha, ou para projetos que você concluiu. Apagar todo dia só custa tempo de build.

Posso apagar com o Xcode aberto? Encerre o Xcode primeiro. Apagar com o Xcode rodando pode deixar um índice pela metade e erros estranhos até você reabri-lo.

Como o DiskAtlas e o Kempt ajudam

Painel de detalhes do DiskAtlas para a pasta Developer: 28.4 GB, marcada como Regenerável, o Xcode recria isso no seu próximo build
O DiskAtlas marca a pasta Developer como Regenerável: o Xcode a recria no seu próximo build.

O DiskAtlas mostra o tamanho do DerivedData e de todas as outras pastas em ~/Library/Developer, em um mapa, e marca cada uma: saída de build que se recria sozinha, downloads que voltam ou seus próprios arquivos. A limpeza do Kempt tem uma categoria Desenvolvimento para a saída de build e os caches do Xcode, marca cada item (Se recria sozinho, É baixado de novo, Olhe primeiro ou Seu) e move só o que você marcar para a Lixeira, para você poder devolver qualquer coisa.

Para o resto do Mac, veja o que você pode apagar com segurança no Mac e como liberar espaço em disco.