빌드 실패의 원인이 코드가 아니라 '용량 부족’일 때, 우리는 무엇을 정리해야 하는가
언리얼 엔진 프로젝트를 진행하다 보면 어느 순간 익숙한 경고를 마주하게 된다. “디스크 공간이 부족합니다.”
빌드가 중간에 실패하고, 에디터가 버벅이며, 셰이더 컴파일이 멈춘다.
문제는 코드가 아니다. C드라이브가 숨을 쉬지 못하는 것이다.
특히 여러 버전의 SDK, 빌드 도구, 드라이버가 층층이 쌓인 개발 PC에서 이 문제는 피할 수 없는 숙명과도 같다.
프로젝트 개발 환경을 정리하면서 약 20GB 이상의 용량을 확보한 기록을 공유한다.
이 글을 통해 다음을 얻을 수 있다:
- 삭제해도 안전한 파일과 폴더의 명확한 구분
- 절대 삭제하면 안 되는 치명적인 폴더 경고
- 각 항목별 예상 확보 용량
- 향후 재발 방지를 위한 설정 팁

1. 문제 정의: 무엇이 용량을 잡아먹고 있는가
증상은 단순했다. C드라이브 여유 공간이 10GB 미만으로 떨어지면서 UE 5.6 빌드가 간헐적으로 실패했다.
셰이더 컴파일 도중 IO 오류가 발생하고, 에디터 응답 속도가 눈에 띄게 느려졌다.
문제는 "무엇을 지워야 하는가"였다. 개발 환경에서는 함부로 파일을 삭제했다가 빌드 체인 전체가 망가질 수 있다.
정확한 분석이 필요했다.
2. 원인 분석: 용량 도둑들의 정체
분석 결과, 용량을 차지하는 주범들은 크게 다섯 가지로 분류됐다.
| 항목 | 위치 | 예상 용량 | 위험도 |
| 최대 절전 모드 파일 | C:\hiberfil.sys | ~27GB | 삭제 안전 |
| VS 설치 캐시 | C:\ProgramData\Microsoft\VisualStudio\Packages | ~15GB | ⚠️ 주의 필요 |
| 구버전 SDK | 제어판 → 프로그램 | ~4GB | 확인 후 삭제 |
| GPU 드라이버 찌꺼기 | C:\NVIDIA, Installer2 폴더 | ~2GB | 삭제 안전 |
| 프로젝트 임시 파일 | AppData\Local\[Project]\Saved | ~1GB | 삭제 안전 |
이 시점에서 깨달은 것이 있다.
Windows와 Visual Studio는 "혹시 모를 상황"을 대비해 원본 파일을 보관하지만,
개발자에게 이 사실을 적극적으로 알려주지 않는다.
3. 해결 과정: 항목별 정리 가이드
3-1. 최대 절전 모드 파일 비활성화 (약 27GB)
hiberfil.sys는 최대 절전 모드를 위해 RAM 전체 내용을 디스크에 저장하는 파일이다.
쉽게 말해, 컴퓨터가 잠들 때 기억을 보관하는 창고와 같다. RAM이 32GB라면 이 파일도 32GB에 육박한다.
SSD 환경에서는 부팅 속도 차이가 거의 없으므로 비활성화해도 무방하다.
:: 관리자 권한 CMD에서 실행
powercfg -h off
이 명령어 하나로 즉시 27.4GB를 확보할 수 있다. 그러나 나는 오페라의 여러 탭에 자료를 띄어놓고 읽으면서 작업을 주로 하는데 이 기능을 끄면 그 브라우저 캐시 기능도 같이 꺼지지 않을까 해서 적용시키지는 않았다.
💡 다른 선택지로 powercfg -h -size 50으로 파일 크기를 절반으로 줄이는 방법도 있다. 하지만 최대 절전 모드를 실제로 사용하지 않는다면 완전 비활성화가 더 깔끔하다.
3-2. Visual Studio 설치 캐시 정리 (약 15GB)
위치: C:\ProgramData\Microsoft\VisualStudio\Packages
이 폴더는 Visual Studio 설치 및 수정 시 필요한 원본 파일의 복사본이다.
보통 15GB~20GB에 달하는 엄청난 공간을 차지한다.
한 번 설치가 완료되면 프로그램 실행이나 프로젝트 빌드에 전혀 영향을 주지 않는다.
나중에 VS 기능을 추가할 때 다시 다운로드하면 될 뿐이다.
⚠️ 치명적 경고: _Instances 폴더는 절대 삭제 금지
Packages 폴더 내부에는 _Instances라는 하위 폴더가 존재한다.
이 폴더는 인스톨러의 “지도” 역할을 한다.
현재 설치된 Visual Studio의 구성 정보, 설치 경로, 버전 정보 등이 모두 이 폴더에 기록되어 있다...
이 사실을 모른채로 그냥 지워버렸다....ㅎㅎ;;
_Instances 폴더를 삭제하면 발생하는 일:
- Visual Studio Installer가 기존 설치를 인식하지 못함
- “설치된 제품이 없습니다” 메시지 표시
- 언리얼 에디터에서 C++ 클래스 생성 시 “컴파일러를 찾지 못했습니다” 오류 발생
- VS 2022가 이미 설치되어 있어도 재설치 요구


🔧 _Instances 삭제 후 복구 방법
만약 실수로 _Instances 폴더를 삭제했다면, 다음 절차로 복구할 수 있다.
1) VS 2022 설치 도우미 직접 내려받기
2025.12.02 - [Dev./UE 언리얼 엔진] - 언리얼 엔진 5.4 + Visual Studio 2026 호환성 문제 해결
언리얼 엔진 5.4 + Visual Studio 2026 호환성 문제 해결
1. 문제 정의 (Problem Definition)1.1 증상언리얼 프로젝트 C++ 빌드 실패빌드 로그에 다음과 같은 오류 발생:__has_feature 매크로 관련 Undefined / Not defined 에러UBT(Unreal Build Tool)에서 Visual Studio Toolchain 인식
raindrovvv.tistory.com
2) 경로 오류(“비어 있지 않은 디렉터리”) 해결법
이미 2022 폴더가 존재하기 때문에 설치가 안 된다고 뜰 것이다.
이때는 아래 순서로 인스톨러를 속여야 한다.
| 단계 | 작업 내용 |
| 1. 잠시 폴더 이름 변경 | C:\Program Files\Microsoft Visual Studio\2022 폴더의 이름을 2022_temp로 바꾼다 |
| 2. 설치 시작 | 방금 받은 2022 설치 도우미를 실행하고, 경로를 원래의 C:\Program Files\Microsoft Visual Studio\2022\Community로 지정하여 설치를 시작한다 |
| 3. 파일 복사 | 설치가 1%라도 진행되어 폴더 구조가 생기면 일시 정지(Pause) 하거나 취소한다 |
| 4. 파일 되돌리기 | 2022_temp\Community에 있던 모든 파일들을 새로 생긴 2022\Community 폴더로 덮어쓴다 |
| 5. 복구(Repair) | 다시 Installer를 열면 이제 [설치됨]에 2022가 뜰 것이다. 여기서 [더 보기] → [복구(Repair)]를 누르면, 인스톨러가 "어? 데이터가 다 있네?"라고 판단하고 삭제된 _Instances 정보만 빠르게 복구한다 |
복구가 끝나면 다시 [설치됨] 탭에 2022 버전이 정상적으로 보일 것이고, 언리얼 프로젝트 파일 생성도 바로 가능해진다.
✅ 안전한 삭제 대상
Packages 폴더 내에서 _Instances를 제외한 나머지 캐시 파일들은 삭제해도 안전하다.
재발 방지 설정:
- Visual Studio Installer 실행
- 우측 상단 ⚙️ → 설정
- “설치 후 다운로드 캐시 유지” 옵션 해제
이 설정을 끄면 앞으로 업데이트할 때마다 캐시가 쌓이는 것을 방지할 수 있다.
3-3. 구버전 SDK 정리 (약 4GB)
개발 PC에는 여러 프로젝트를 거치며 설치된 다양한 버전의 SDK가 공존한다.
하지만 현재 프로젝트의 타겟 버전만 명확히 안다면 과감하게 정리할 수 있다.
Windows SDK:
- 문제: Windows 10 SDK(19041)와 Windows 11 SDK(22621, 26100)가 중복 설치
- 해결: 오래된 10.0.19041 버전 삭제
.NET SDK:
- 문제: 지원이 종료된 .NET Core 2.1 버전이 잔존
- 해결: 프로젝트의 global.json(프로젝트가 요구하는 .NET 버전을 명시하는 설정 파일)에서 지정한 9.0.x와 UE 빌드에 필요한 8.0만 남기고 삭제
⚠️ SDK 삭제 전 반드시 프로젝트 설정에서 요구하는 버전을 확인한다. 무작정 삭제하면 빌드 체인이 망가질 수 있다.
3-4. GPU 드라이버 설치 찌꺼기 (약 2GB)
NVIDIA 드라이버를 업데이트하면 두 곳에 찌꺼기가 남는다.
| 경로 | 내용 | 삭제 가능 여부 |
| C:\NVIDIA | 드라이버 설치 전 압축 해제 임시 폴더 | ✅ 통째로 삭제 가능 |
| C:\Program Files\NVIDIA Corporation\Installer2 | 이전 버전 설치 파일 백업 | ✅ 삭제 가능 |
설치가 완료된 시점에서 이 파일들은 아무런 역할을 하지 않는다.
4. 핵심 요약: 삭제 가능 vs 삭제 금지
구분 대상 비고
| ✅ 삭제 가능 | hiberfil.sys (최대 절전 모드) | 명령어로 비활성화 |
| ✅ 삭제 가능 | Packages 폴더 내 캐시 파일들 | _Instances 제외 |
| ✅ 삭제 가능 | C:\NVIDIA | 설치 후 불필요 |
| ✅ 삭제 가능 | 구버전 SDK | 버전 확인 필수 |
| ⛔ 삭제 금지 | Packages\_Instances | VS 설치 정보 보관 |
| ⛔ 삭제 금지 | 현재 사용 중인 SDK | 빌드 실패 유발 |
5. 주기 점검 체크리스트
아래 체크리스트를 월 1회 정도 확인하면 쾌적한 개발 환경을 유지할 수 있다.
- [ ] C:\NVIDIA 폴더 확인 및 삭제
- [ ] VS Installer에서 불필요한 구성 요소 제거
- [ ] Packages 폴더 정리 (⚠️ _Instances는 절대 건드리지 않기)
- [ ] %TEMP% 폴더 정리
- [ ] 사용하지 않는 SDK 버전 확인
- [ ] 프로젝트별 Saved 폴더 점검
정기적인 정리가 개발 생산성을 지키는 길이다.
단, 무엇을 지워도 되고 무엇을 지우면 안 되는지 명확히 구분하는 것이 가장 중요하다.
'Dev. > 기타 개발 관련' 카테고리의 다른 글
| 다시 정리해보는 GitKraken Workflow (0) | 2026.03.08 |
|---|---|
| GitKraken Desktop 11.10 업데이트 정리 (0) | 2026.03.08 |
| GitHub 커밋 알림을 Discord로 받는 법: Webhook 설정 (0) | 2026.01.23 |
| Git Push의 공포... Azure DevOps와 LFS 413 에러 (0) | 2025.12.15 |
| 🫧Clean Code :: 클린 코드 가이드 (0) | 2025.03.28 |