Xcode DerivedData, 빌드 캐시 및 미사용 시뮬레이터 안전 정리
빌드 환경을 손상시키지 않고 Mac에서 Xcode DerivedData, 모듈 캐시 및 사용되지 않는 iOS 시뮬레이터를 정리하기 위한 단계별 개발자 가이드입니다.

iOS, macOS 및 visionOS 개발자에게 Xcode는 필수 도구입니다. 그러나 개발자의 Mac에서는 중요한 스토리지 소비자가 될 수도 있습니다. 수개월에 걸친 빌드, 테스트 및 디버깅을 통해 Xcode는 인덱스 저장소, 중간 빌드 아티팩트, 모듈 캐시, 아카이브 및 시뮬레이터 런타임을 축적합니다.
Xcode 빌드 디렉터리 및 시뮬레이터는 활성 프로젝트 수, 종속성 및 시뮬레이터 런타임에 따라 시간이 지남에 따라 상당한 디스크 공간을 소비할 수 있습니다. 스토리지가 부족해지면 빌드 작업 속도가 느려지고 인덱싱 문제가 발생할 수 있습니다. 프로젝트 구성을 손상시키지 않고 Xcode DerivedData, 빌드 캐시 및 사용하지 않는 iOS 시뮬레이터를 안전하게 정리하는 방법은 다음과 같습니다.
Xcode DerivedData는 무엇이며 왜 성장합니까?
Xcode는 ~/Library/Developer/Xcode/DerivedData에 위치한 중앙 디렉터리에 빌드 시간 정보를 저장합니다. 이 디렉토리 내에서 Xcode는 사용자가 여는 각 프로젝트 및 작업 공간에 대한 전용 하위 폴더를 생성합니다.
DerivedData에는 다음이 포함됩니다. 1. 인덱싱 데이터: 코드 완성 및 빠른 도움말에 사용되는 구문 맵, 기호 그래프 및 상호 참조. 2. 제품 구축: 중간 개체 파일(.o), 사전 컴파일된 프레임워크 및 dSYM. 3. 모듈 캐시: 사전 컴파일된 Swift 및 Clang 모듈. 이전 빌드, 이름이 변경된 대상 또는 보관된 분기의 아티팩트가 누적될 수 있으므로 DerivedData는 지워질 때까지 확장되는 경향이 있습니다.
DerivedData를 삭제해도 안전한가요?
DerivedData에는 Xcode가 일반적으로 다시 생성할 수 있는 생성된 빌드 및 인덱싱 데이터가 포함되어 있습니다. 이를 제거하면 전체 재구축 및 재색인이 실행될 수 있으므로 프로젝트 또는 아카이브 데이터가 아닌 DerivedData를 삭제하는지 확인하세요.
DerivedData를 지우는 것은 Xcode가 비정상적으로 작동하거나 지속적인 빌드 오류를 표시하거나 Swift Package Manager 종속성을 해결하지 못하는 경우 Apple 개발자 커뮤니티의 표준 문제 해결 단계입니다. Xcode가 코드베이스를 다시 색인화하고 종속성을 다시 컴파일해야 하기 때문에 후속 빌드에는 시간이 더 오래 걸린다는 점을 명심하세요.
DerivedData를 청소하는 수동 방법
Xcode 설정 또는 Finder를 사용하거나 터미널을 통해 수동으로 DerivedData를 청소할 수 있습니다.
• Xcode 설정 및 Finder를 통해(권장): Xcode → 설정(Command + ,) → 위치를 엽니다. '파생 데이터'에서 경로 옆에 있는 작은 화살표 아이콘을 클릭하여 Finder에서 폴더를 엽니다. DerivedData 내부에 있는지 확인하고 Xcode를 종료한 다음 프로젝트 하위 폴더를 선택하여 휴지통로 이동합니다. 이를 통해 제거되는 항목을 검사하고 필요한 경우 휴지통에서 파일을 복구할 수 있습니다.
• 터미널 사용(고급): 명령줄 워크플로를 선호하는 경우 먼저 Xcode를 종료하고 다음을 실행합니다. rm -rf ~/Library/Developer/Xcode/DerivedData/* . rm -rf는 파일을 휴지통로 이동하지 않고 즉시 영구적으로 삭제하므로 실행하기 전에 경로를 주의 깊게 확인하십시오.
사용하지 않은 iOS, watchOS 및 tvOS 시뮬레이터 청소
Xcode를 통해 다운로드된 각 시뮬레이터 런타임은 수 기가바이트의 스토리지를 소비합니다. 시간이 지나면서 새로운 OS 업데이트가 설치되어도 이전 시뮬레이터 버전이 드라이브에 남아 있습니다.
설치된 시뮬레이터를 검사하려면 터미널에서 xcrun simctl list를 실행하세요. 사용할 수 없거나 분리된 시뮬레이터 장치를 제거하고 캐시를 지우려면 xcrun simctl delete unavailable를 실행하세요. Xcode 설정 → 구성 요소로 이동하여 더 이상 테스트하지 않는 다운로드한 플랫폼 시뮬레이터 런타임을 보고, 관리하고, 제거할 수도 있습니다.
Xcode 스토리지 유지 관리와 함께 Smart Cleaner AI 사용
개발자 스토리지를 관리할 때 육안 검사를 통해 드라이브 용량이 어디에 집중되어 있는지 파악하는 데 도움이 됩니다.
Smart Cleaner AI의 디스크 분석기는 시스템 전체에서 스캐너에 표시되는 저장 공간이 많은 폴더와 파일을 검사하는 데 도움이 될 수 있습니다. DerivedData 관리, 빌드 제품 및 시뮬레이터 관리와 같은 Xcode 관련 정리는 Xcode 설정, Finder 및 개발자 명령줄 도구를 사용하여 검토하고 수행하여 프로젝트 구성이 그대로 유지되도록 해야 합니다.
Xcode DerivedData와 시뮬레이터를 정리하는 4단계 방법
- 1
Xcode를 완전히 종료합니다.
캐시 제거를 수행하기 전에 Xcode 및 모든 활성 시뮬레이터 인스턴스가 닫혀 있는지 확인하십시오.
- 2
Finder에서 DerivedData를 찾습니다.
Xcode 설정 → 위치를 열고 DerivedData 옆에 있는 화살표를 클릭하거나 Finder에서 ~/Library/Developer/Xcode/DerivedData로 직접 이동하세요.
- 3
DerivedData 빌드 하위 폴더 삭제
DerivedData 내에서 원하지 않는 프로젝트 폴더를 선택하여 Trash로 보냅니다. Xcode는 재구축 시 새로운 인덱스를 다시 생성합니다.
- 4
구성요소 또는 터미널에서 시뮬레이터 관리
터미널에서 xcrun simctl delete unavailable를 사용하거나 Xcode 설정 → 구성 요소를 열어 사용하지 않는 시뮬레이터 런타임을 삭제하세요.
개발자 저장 공간을 확인하고 디스크 공간 확보하기
Smart Cleaner AI: Disk Clean는 디스크 사용량을 시각화하고, 대용량 파일을 찾고, 불필요한 애플리케이션 캐시를 제거하여 Mac를 빠르고 간결하게 유지할 수 있도록 도와줍니다.
자주 묻는 질문
DerivedData를 삭제하면 내 소스 코드나 Git 기록도 삭제되나요?▼
아니요. DerivedData에는 임시 빌드 아티팩트와 인덱스만 포함됩니다. 프로젝트 파일, 소스 코드 및 Git 리포지토리는 완전히 그대로 유지됩니다.
DerivedData를 삭제한 후 첫 번째 빌드가 느린 이유는 무엇입니까?▼
Xcode는 내부 기호 인덱스를 다시 빌드하고 Swift 패키지를 처음부터 다시 컴파일해야 하기 때문입니다. 후속 증분 빌드는 최대 속도로 돌아갑니다.
Xcode 아카이브는 어디에 저장되어 있나요?▼
Xcode는 ~/Library/Developer/Xcode/Archives/에 배포 아카이브를 저장합니다. Xcode Organizer(Window → Organizer)를 통해 이전 개발 아카이브를 검토하고 삭제할 수 있습니다.
DerivedData를 외장 SSD로 옮길 수 있나요?▼
예, Xcode 설정 → 위치에서 외부 NVMe 드라이브에 사용자 지정 DerivedData 경로를 설정할 수 있지만 내부 Mac SSD는 더 빠른 빌드 처리량을 제공합니다.
개발자는 DerivedData를 얼마나 자주 청소해야 합니까?▼
개발자는 일반적으로 인덱싱 또는 컴파일 오류 문제를 해결할 때, 주요 Xcode 업데이트 후 또는 오래된 비활성 프로젝트에서 스토리지를 회수할 때 DerivedData를 정리합니다.
출처
Ready when you are
Download Smart Cleaner AI for Mac
Analyze Mac storage, safely clear system data caches, find large files, and remove app leftovers with on-device controls.
By using Smart Cleaner AI, you agree to our Terms of Use and Privacy Policy.