본문 바로가기
Unreal

[UE5] C++ 클래스를 안전하게 지우는 방법

by Oz Driver 2026. 2. 9.

C++ 클래스는 컨텐츠 드로어에서 삭제 버튼이 없습니다.

그래서 VS 에서 지우고 폴더에서도 지워버리면, 엔진이 그 다음부터는 이상하게 동작을 하는 경우들이 종종 있습니다.

오늘은 가장 깔끔하고 안전하게 C++ 클래스를 제거하는 방법을 정리하겠습니다. 

 

1. 왜 그냥 지우면 안 되나요?

언리얼 C++은 단순히 파일만 있는 게 아니라, Reflection(리플렉션) 시스템에 의해 엔진과 복잡하게 얽혀 있습니다.

  •  .h / .cpp: 실제 소스 코드

  •  Intermediate 폴더: 엔진이 코드를 분석해 만든 임시 데이터 (지운 파일의 정보가 여기 남음)

  •  Binaries 폴더: 컴파일된 결과물 (.dll)

  •  .sln 파일: Visual Studio가 관리하는 파일 명단

파일만 지우면 엔진과 VS는 "명단에는 있는데 실물이 없네?"라며 에러를 발생시킵니다

 

2. VS 사용시, C++ 클래스 삭제 방법

언리얼 엔진을 사용하면 중간 산물들이 생기는 폴더들이 있습니다. 

이것들은 일종의 캐시로 작용하기 때문에 엔진에 이해할 수 없는 일들이 발생한다면, 일단 이 폴더들을 지우고 새로 빌드를 하는 것이 좋습니다. 아래의 폴더들은 지워도 상관없는 파일들입니다. 

물론 지우고 새로 생성하는 과정에서 시간 비용이 좀 많이 들어갑니다. 

 

  •  .vs (비주얼 스튜디오 캐시)

  •  Binaries (빌드 결과물)

  •  Intermediate (언리얼 중간 생성 파일)

  •  [프로젝트명].sln (솔루션 파일)

 

만약 위의 폴더들을 지웠다면 반드시 .uproject 파일을 우클릭해서 "Generate Visual Studio project files" 를 눌러주어야 합니다. 그래야 지워진 폴더들을 대신할 '새로운 지도'가 그려집니다.