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ń.

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.
- 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.
- 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.
- 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.
- 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.
- 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.
| Decyzja | Miejsce kontroli lub działania | Skutek i weryfikacja |
|---|---|---|
| Przed odinstalowaniem zabezpiecz dane, których nie da się odtworzyć | Projects / Xcode Organizer / Archives | 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. |
| Usuń aplikację tą samą metodą, którą ją zainstalowano | /Applications/Xcode.app / Finder | 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ć. |
| Sprawdź wszystko przed opróżnieniem Kosza | xcode-select -p / Activity Monitor | 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. |
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