AskCleanAskClean

Jak całkowicie odinstalować Xcode z Maca bez utraty projektów i dSYM

Zespół AskClean · Zaktualizowano 2026-09-01

Przed całkowitą deinstalacją Xcode wykonaj kopie projektów i zachowaj Archives oraz dSYM potrzebne dla wydanych buildów. Następnie przenieś aplikację do Kosza i osobno przejrzyj DerivedData, symulatory, DeviceSupport i narzędzia wiersza poleceń.

Jak całkowicie odinstalować Xcode z Maca bez utraty projektów i dSYM
Przed całkowitą deinstalacją Xcode wykonaj kopie projektów i zachowaj Archives oraz dSYM potrzebne dla wydanych buildów. Następnie przenieś aplikację do Kosza i osobno przejrzyj DerivedData, symulatory, DeviceSupport i narzędzia wiersza poleceń.

Przed odinstalowaniem zabezpiecz dane, których nie da się odtworzyć

Foldery projektów nie są pozostałościami Xcode. Zabezpiecz repozytoria, niezatwierdzone pliki, lokalne pakiety i zasoby. Zachowaj Archives/dSYM wersji nadal używanych w App Store, TestFlight lub u klientów oraz potrzebny stan Simulator.

  1. Najpierw zamknij Xcode. Usuwanie DerivedData przy działającym Xcode może zdezorientować jego indekser, a pliki otwarte przez Xcode mogą nie usunąć się czysto.
  2. Znajdź folder: w Xcode otwórz Settings > Locations i kliknij małą strzałkę obok ścieżki DerivedData, by pokazać go w Finderze. Albo w Finderze naciśnij Command-Shift-G i wpisz bezpośrednio ~/Library/Developer/Xcode/DerivedData.
  3. Posortuj podfoldery projektów według wielkości, zaznacz te do skasowania (albo Command-A, by wziąć wszystkie) i przenieś je do Kosza. Najpierw Kosz to bezpieczniejszy nawyk — jeśli zmienisz zdanie, przywrócisz je natychmiast.
  4. Zamiast tego z Terminala: rm -rf ~/Library/Developer/Xcode/DerivedData usuwa wszystko za jednym zamachem. Dla bardzo dużych folderów jest szybsze niż Finder, ale przed użyciem przeczytaj uwagę poniżej.
  5. Otwórz Xcode ponownie i skompiluj. Licz się z tym, że pierwsza kompilacja każdego projektu potrwa zauważalnie dłużej, a na pasku aktywności przez chwilę będzie widoczne „Indexing” — oba koszty są jednorazowe.

Ostrożnie z rm -rf: omija Kosz i usuwa bezpowrotnie, bez cofnięcia. Wpisz ścieżkę dokładnie, nigdy nie uruchamiaj tego z sudo do tego zadania, a jeśli Terminal to nie Twój żywioł, droga przez Finder robi to samo — odwracalnie.

Usuń DerivedData

Są trzy sposoby i wszystkie kończą w tym samym miejscu. Polecenie Clean Build Folder w Xcode (Product > Clean Build Folder albo Command-Shift-K) czyści produkty kompilacji tylko dla aktualnie otwartego projektu — przydatne przy naprawianiu dziwnej kompilacji, ale wskazówki zajętości dysku prawie nie rusza. Aby odzyskać realne miejsce, usuń same foldery DerivedData.

Usuwanie per projekt to opcja chirurgiczna: zostaw DerivedData dla dwóch-trzech projektów kompilowanych codziennie, a foldery całej reszty skasuj. Usunięcie całości to opcja szybka — też w porządku, tylko płacisz koszt pełnej odbudowy wszystkich projektów naraz.

Usuń aplikację tą samą metodą, którą ją zainstalowano

Zakończ Xcode i Simulator, a właściwy Xcode.app przenieś w Finderze do Kosza. Nie usuwaj automatycznie /Library/Developer/CommandLineTools — Git, Homebrew, clang i skrypty buildów mogą ich nadal używać.

Pamięci podręczne menedżerów pakietów (SwiftPM, CocoaPods, npm, Homebrew)

Menedżery pakietów zachowują każdą pobraną kiedykolwiek zależność, by przyszłe instalacje były szybkie. To dobra inżynieria i zła higiena dysku: te pamięci podręczne tylko rosną, a na maszynie z kilkuletnim stażem projektów po cichu składają się na 10-20 GB. Wszystkie można bezpiecznie wyczyścić — w najgorszym razie następna instalacja pobierze pakiety ponownie.

Swift Package Manager buforuje pobrane pakiety w ~/Library/Caches/org.swift.swiftpm, a rozwiązane checkouty każdego projektu żyją też w jego folderze DerivedData — więc czyszcząc DerivedData, czyścisz i je. Wspólną pamięć podręczną usuniesz z Findera albo poleceniem rm -rf na tej ścieżce.

Sprawdź wszystko przed opróżnieniem Kosza

Ponownie sprawdź Applications, procesy i xcode-select -p. Potwierdź obecność projektów, potrzebnych Archives/dSYM i danych Simulator przed opróżnieniem Kosza. System Data może zaktualizować się później.

Mapa bezpieczeństwa pełnego odinstalowania

Usuń Xcode, oddzielając odtwarzalne cache od Archives, DeviceSupport, danych Simulator i Command Line Tools.

DecyzjaMiejsce kontroli lub działaniaSkutek i weryfikacja
Przed odinstalowaniem zabezpiecz dane, których nie da się odtworzyćProjects / Xcode Organizer / ArchivesFoldery projektów nie są pozostałościami Xcode. Zabezpiecz repozytoria, niezatwierdzone pliki, lokalne pakiety i zasoby. Zachowaj Archives/dSYM wersji nadal używanych w App Store, TestFlight lub u klientów oraz potrzebny stan Simulator.
Usuń aplikację tą samą metodą, którą ją zainstalowano/Applications/Xcode.app / FinderZakończ Xcode i Simulator, a właściwy Xcode.app przenieś w Finderze do Kosza. Nie usuwaj automatycznie /Library/Developer/CommandLineTools — Git, Homebrew, clang i skrypty buildów mogą ich nadal używać.
Sprawdź wszystko przed opróżnieniem Koszaxcode-select -p / Activity MonitorPonownie sprawdź Applications, procesy i xcode-select -p. Potwierdź obecność projektów, potrzebnych Archives/dSYM i danych Simulator przed opróżnieniem Kosza. System Data może zaktualizować się później.

FAQ

Czy mogę usunąć całe ~/Library/Developer?

Nie. Oprócz odtwarzalnego DerivedData zawiera Archives/dSYM, DeviceSupport, runtimes i stan Simulator; oceń każdą kategorię osobno.

Czy usunięcie DerivedData jest bezpieczne?

Tak — to jedno z najbezpieczniejszych dużych usunięć na Macu. DerivedData zawiera wyłącznie pliki, które Xcode generuje z Twojego źródła: produkty kompilacji, pamięci podręczne modułów, indeksy i logi. Twój kod, pliki projektu i historia gita mieszkają gdzie indziej i nic im nie grozi. Jedyną konsekwencją jest to, że następna kompilacja każdego projektu jest pełną odbudową, a indeksowanie działa ponownie.

Jak często czyścić DerivedData?

Nie ma obowiązkowego harmonogramu — czyść, gdy jest na tyle duże, by miało znaczenie, co u większości aktywnych deweloperów oznacza co miesiąc lub dwa. Dwie sytuacje zawsze to uzasadniają: gdy pilnie potrzebujesz miejsca na dysku i gdy projekt pokazuje niewytłumaczalne błędy kompilacji albo nieświeże autouzupełnianie — tam wyczyszczenie DerivedData to standardowa pierwsza naprawa.

Źródła

Powiązane poradniki pełnej deinstalacji