필요없어진 C++ 클래스 삭제하기 | 언리얼 4

C++ 클래스 삭제가 필요한 이유

언리얼 엔진 4에서 작업하다 보면 프로토타입 단계에서 만든 클래스가 나중에 쓸모없어지는 일이 자주 생겨요. 블루프린트 클래스는 콘텐츠 브라우저에서 우클릭 → 삭제로 간단히 처리되지만, C++ 클래스는 에디터 내에서 삭제 옵션이 비활성화되어 있어요. 그래서 많은 개발자들이 파일을 그냥 쌓아두거나, 잘못 지웠다가 프로젝트가 깨지는 경험을 하곤 하죠.

C++ 클래스를 방치하면 솔루션 탐색기가 복잡해지고, 빌드 시간도 길어질 수 있어요. 특히 팀 프로젝트에서는 불필요한 파일이 많으면 코드 리뷰나 유지보수 비용이 커집니다. 반면 블루프린트는 레퍼런스 체크 기능이 있어서 실수할 위험이 적지만, C++는 그런 안전장치가 없기 때문에 수동으로 관리해야 해요.

필요없는 클래스를 제때 정리하면 프로젝트 구조가 깔끔해지고, 이후에 새로운 기능을 추가할 때 혼란을 줄일 수 있어요. 특히 소규모 팀이나 1인 개발자라면 이 습관이 개발 속도를 크게 높여줍니다.

단계별 C++ 클래스 삭제 방법

먼저 언리얼 에디터를 완전히 종료해야 해요. 에디터가 실행된 상태에서 파일을 지우면 Visual Studio와의 동기화가 깨져서 문제가 생길 수 있거든요. 에디터를 닫은 뒤 Visual Studio 솔루션 탐색기에서 삭제할 클래스의 .h와 .cpp 파일을 선택하고 ‘제거’를 클릭하세요.

다음으로 프로젝트 폴더 안의 Source 디렉토리로 가서 같은 파일들을 직접 삭제해야 해요. 솔루션 탐색기에서 제거만 하면 디스크에는 파일이 남아있기 때문에 반드시 수동 삭제가 필요합니다. 파일을 지운 후에는 Visual Studio에서 ‘빌드 > 솔루션 다시 빌드’를 실행하세요. 이 과정을 통해 컴파일러가 변경 사항을 완전히 인식하게 됩니다.

빌드가 성공적으로 끝나면 에디터를 다시 실행하고 콘텐츠 브라우저를 확인해 보세요. 삭제한 C++ 클래스가 더 이상 보이지 않는다면 작업이 완료된 거예요. 이 방법은 Unreal Engine 4.26~4.27 버전에서도 동일하게 적용됩니다.

삭제 시 주의사항과 오류 해결

C++ 클래스를 삭제할 때는 먼저 해당 클래스가 레벨에 배치되어 있는지, 다른 클래스에서 참조하고 있는지 반드시 확인해야 해요. 블루프린트가 이 C++ 클래스를 부모로 상속받고 있다면 삭제 후 바로 컴파일 에러가 발생합니다. 미리 ‘Find References’ 기능을 사용하거나, 클래스 이름을 검색해 사용처를 확인하는 습관을 들이세요.

삭제 후 빌드가 실패하면 Visual Studio 오류 목록을 열어서 어떤 파일이 문제를 일으키는지 확인하세요. 주로 Include 문이 남아있거나, 생성자 호출 부분이 지워지지 않은 경우가 많아요. 이런 에러는 보통 한두 개의 파일만 수정하면 해결됩니다.

만약 자주 클래스를 지워야 하는 상황이라면, Git 같은 버전 관리 도구로 백업을 먼저 해두는 것도 좋은 방법이에요. 삭제한 클래스를 나중에 다시 필요로 할 때 복구하기 훨씬 수월해집니다.