Пропозиція для перших покупців: усі програми, які ми робимо, з оновленнями назавжди, за $25 один раз. Лише для перших 50 покупцівПереглянути пропозицію
Українська

Посібники

Чи безпечно видаляти DerivedData з Xcode? Так, і ось як

Оновлено 27 жовтня 2026

Так, це безпечно. ~/Library/Developer/Xcode/DerivedData містить результати збірки: скомпільовані файли, індекси, журнали й проміжні продукти. Нічого з цього не є вашим кодом, і Xcode відтворює все потрібне, коли ви наступного разу відкриєте чи зберете проєкт. Видалення коштує вам однієї повільнішої збірки на проєкт, а не даних.

Цей посібник пояснює, що всередині, коли варто видаляти, три способи це зробити й інші папки Xcode, що розростаються так само.

Що таке DerivedData

Щоразу, коли Xcode збирає проєкт, він записує результати не в папку проєкту, щоб ваш код залишався чистим. Це місце і є DerivedData. Кожен проєкт отримує всередині власну папку з назвою проєкту й суфіксом, схожим на випадковий, наприклад MyApp-bxkqzfvhgmwtadfhtbtuyzthmdyk.

У папці кожного проєкту зазвичай є:

  • Build: скомпільована програма, фреймворки й проміжні об’єктні файли.
  • Index.noindex: індекс для автодоповнення коду, переходу до визначення й пошуку.
  • Logs: журнали збірки, тестів і запуску.
  • SourcePackages: копії пакетів Swift, від яких залежить проєкт.
  • ModuleCache.noindex (на верхньому рівні): попередньо скомпільовані модулі, спільні для проєктів.

Наскільки великою вона стає?

Залежить від того, скільки проєктів ви збираєте і які вони великі. Одна програма може займати кілька гігабайтів; Mac, на якому за рік-два зібрали багато проєктів, часто тримає тут десятки гігабайтів. Папки видалених чи покинутих проєктів залишаються назавжди, бо Xcode ніколи їх не прибирає.

Щоб побачити розмір, відкрийте Finder, виберіть Перейти, Перейти до папки, введіть ~/Library/Developer/Xcode/DerivedData і натисніть Return. Потім застосуйте до папки Файл, Отримати інформацію або перейдіть у вигляд списку й увімкніть Перегляд, Показати параметри перегляду, Обчислювати всі розміри, щоб побачити розмір кожної папки проєкту одразу.

Що ви втрачаєте, видаляючи її

Час, а не дані:

  • Наступна збірка кожного проєкту буде чистою. Великі проєкти можуть збиратися кілька хвилин там, де інкрементна збірка займала секунди.
  • Xcode переіндексує проєкт. Кілька хвилин після відкриття автодоповнення й пошук працюють повільніше чи неповно.
  • Пакети Swift завантажаться знову під час наступної збірки, бо їхні копії лежали в SourcePackages. Для цього потрібна мережа.
  • Старі журнали збірок зникнуть. Якщо вам потрібен журнал минулої збірки, спершу скопіюйте його.

Ваш код, параметри проєкту, параметри підпису, схеми й історія Git лежать у папці проєкту, а не в DerivedData. Нічого з цього не зачіпається.

Коли варто видаляти

  • Вона дуже розрослася, а вам потрібне місце.
  • Збірка падає без жодного сенсу: «No such module», застарілі помилки пакетів Swift, попередні перегляди, що не оновлюються, або автодоповнення, яке показує давно видалене. Свіжа DerivedData виправляє дивовижно багато таких випадків.
  • Проєкти, над якими ви більше не працюєте. Їхні папки є чистою марнотою. Можна видалити лише їх, а решту залишити.
  • Після великого оновлення Xcode, коли старі кеші модулів уже не відповідають новому компілятору.

Якщо хочете виправити лише один проєкт, спершу спробуйте Product, Clean Build Folder (Shift-Command-K). Це очищує продукти збірки цього проєкту, не зачіпаючи індекс та інші проєкти.

Як видалити DerivedData

У будь-якому разі спершу закрийте Xcode. Запущений Xcode може записувати в папку й відтворюватиме її частини, поки ви видаляєте.

У Finder

  1. У Finder виберіть Перейти, Перейти до папки і введіть ~/Library/Developer/Xcode/DerivedData.
  2. Виберіть усе всередині або лише папки проєктів, які вам більше не потрібні.
  3. Перенесіть їх у Смітник і очистьте його, коли ваші проєкти знову зберуться.

Через параметри Xcode

Відкрийте Xcode, Settings, Locations. У розділі Derived Data маленька стрілка біля шляху відкриває папку у Finder, де її можна видалити, як описано вище. Тут же можна перенести DerivedData в інше місце, наприклад на зовнішній диск, якщо ваш завантажувальний диск малий.

У Терміналі

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

Це видаляє одразу; нічого не йде в Смітник. Вводьте точно, бо rm -rf з неправильним шляхом видалить усе, на що вказує цей шлях.

Інші папки Xcode, що розростаються

DerivedData рідко є єдиним великим вмістом у ~/Library/Developer. Ось що там є ще і чого коштує видалення кожного.

ПапкаЩо міститьБезпечно видаляти?
Xcode/DerivedDataРезультати збірки й індексиТак. Відновлюється під час наступної збірки
Xcode/iOS DeviceSupport (також watchOS, tvOS)Символи налагодження, скопійовані з кожного пристрою й версії ОС, які ви підключалиТак, для старих версій ОС. Скопіюються знову, коли цей пристрій підключиться наступного разу
Xcode/ArchivesКожна збірка, яку ви архівували для TestFlight чи App Store, з її символами налагодженняЗалиште ті, що ви випустили. Їхні символи перетворюють звіти про збої на зрозумілі стеки викликів
CoreSimulator/DevicesКожен створений вами симулятор із його програмами й данимиСтарі так. Використовуйте команду нижче, а не Finder
CoreSimulator/CachesКеші симуляторівТак. Відновлюються за потреби
Середовища виконання симулятораЦілі версії iOS, watchOS і visionOS для симулятора, часто по кілька ГБ кожнаСтарі так. Видаляйте їх у параметрах Xcode

Симулятори

Симулятори для версій iOS, яких у вас уже немає, залишаються як «unavailable». Ця команда видаляє лише їх:

xcrun simctl delete unavailable

Щоб видалити ціле середовище виконання симулятора, відкрийте Xcode, Settings, Components (у Xcode 15 це Platforms), виберіть старе середовище й видаліть його.

Пакети Swift та інші кеші розробки

~/Library/Caches/org.swift.swiftpm містить завантажені пакети Swift, спільні для проєктів. Очищати безпечно; пакети завантажаться знову за потреби. Якщо ви також користуєтеся CocoaPods, Carthage, Homebrew, npm чи Docker, кожен має власний кеш, і вони можуть бути ще більшими, ніж у Xcode.

Як не дати їй розростися знову

  • Раз на кілька місяців видаляйте папки DerivedData завершених чи покинутих проєктів.
  • Запускайте xcrun simctl delete unavailable після кожного оновлення Xcode.
  • Видаляйте середовища виконання симулятора для версій ОС, які ви більше не тестуєте.
  • Якщо місця на диску мало, перенесіть DerivedData на зовнішній SSD у Settings, Locations.

Запитання

Чи видалить видалення DerivedData мій код? Ні. Ваш код і файли проєкту лежать у папці проєкту. DerivedData містить лише те, що Xcode з них згенерував.

Чи зламає це мій репозиторій Git? Ні. Git не відстежує DerivedData, і ніщо в ній не належить вашому репозиторію.

Чи треба видаляти її часто? Ні. Видаляйте, коли вона велика, коли збірки поводяться дивно, або для завершених проєктів. Щоденне видалення лише забирає час на збірку.

Чи можна видаляти її, коли Xcode відкритий? Спершу закрийте Xcode. Видалення під запущеним Xcode може залишити напівзаписаний індекс і дивні помилки, доки ви його не перезапустите.

Як допомагають DiskAtlas і Kempt

Панель подробиць DiskAtlas для папки Developer: 28.4 ГБ, позначено як «Відтворюване», Xcode відновить це під час наступної збірки
DiskAtlas позначає папку Developer як «Відтворюване»: Xcode відновить її під час наступної збірки.

DiskAtlas показує на одній мапі, скільки займають DerivedData й кожна інша папка в ~/Library/Developer, і позначає кожну: результати збірки, що відновлюються самі, завантаження, що повертаються, або ваші власні файли. Очищення в Kempt має категорію «Розробка» для результатів збірки й кешів Xcode, позначає кожен елемент («Відновлюється само», «Завантажиться знову», «Спершу перегляньте» або «Ваше») і переносить у Смітник лише позначене, тож усе можна повернути.

Для решти Mac дивіться, що можна безпечно видалити на Mac і як звільнити місце на диску.