언리얼 엔진 5.4 + Visual Studio 2026 호환성 문제 해결

 

1. 문제 정의 (Problem Definition)

1.1 증상

• 언리얼 프로젝트 C++ 빌드 실패
• 빌드 로그에 다음과 같은 오류 발생:
  • __has_feature 매크로 관련 Undefined / Not defined 에러
  • UBT(Unreal Build Tool)에서 Visual Studio Toolchain 인식 실패

1.2 발생 배경

• Visual Studio를 2026(Preview/최신 버전) 으로 업데이트하여 사용.
• 기존 언리얼 프로젝트가 VS2026에서도 처음엔 빌드되었음 → 그래서 VS2022를 삭제.
• 그러나 이후 언리얼 빌드 과정에서 __has_feature 매크로 미정의(Undefined macro) 오류 발생하며 빌드 불가.
• 언리얼 엔진은 VS2026을 정식 지원하지 않음 → 툴체인 충돌 발생
• VS2022는 공식 다운로드 페이지에서 구독제 요구로 일반 다운로드 불가

---

2. 원인 분석 (Root Cause Analysis)

언리얼 엔진은 Visual Studio 2022 Toolchain(MSVC v143)을 필수로 요구하지만,
VS2026은 Preview 버전으로 엔진이 사용하는 C++ Toolchain과 완전 호환되지 않음.

따라서 VS2022 삭제 후 VS2026만 있는 시스템에서
엔진이 필요한 __has_feature 및 C++ 헤더 체크가 실패 → 빌드 불가.

---

3. 해결 절차 (Resolution Procedure)

아래 절차는 기존 VS2022가 삭제되었거나 설치되어 있지 않은 환경 기준.

Step 1. 새 언리얼 C++ 프로젝트 생성

1. 언리얼 엔진 실행
2. 새 빈 프로젝트 생성
3. 프로젝트 로드 후, C++ 클래스 추가
4. 엔진이 툴체인을 체크하며 다음 팝업 표시:
   • “Visual Studio 2022가 필요합니다”
   • → 이 경로가 VS2022 재설치를 위한 가장 안전한 방법

---

Step 2. 팝업을 통해 Visual Studio 2022 설치

1. 팝업에서 Install Visual Studio 2022 클릭
2. Visual Studio Installer 실행
3. Installer가 엔진이 요구하는 구성요소를 자동 체크

그냥 넘어가도 된다.

📌 주의: Microsoft 공식 홈페이지가 아니라 Visual Studio Installer를 통해서만 VS2022 무료 다운로드 가능.

---

Step 3. 언리얼 필수 구성요소 선택 후 설치

Visual Studio Installer에서 다음 항목이 체크되어 있는지 확인:

✔ 필수 Workload

• Desktop development with C++

✔ 필수 Individual Components

• Windows 10/11 SDK
• MSVC v143 C++ Toolset
• C++ CMake tools
• C++ ATL for v143
• .NET Framework targeting pack
• 기타 언리얼 엔진이 자동 체크하는 옵션

---

Step 4. 프로젝트 솔루션 Rebuild

1. Visual Studio 2022로 솔루션(.sln) 열기
2. 시작 프로젝트 설정 확인
   • 반드시 프로젝트명(Game Module) → “시작 프로젝트로 설정”
   • UE5 엔진 자체를 시작 프로젝트로 설정하면 빌드 실패
3. Rebuild Solution

---

Step 5. 언리얼 에디터에서 재컴파일 테스트

• 언리얼 에디터에서 Compile 버튼 클릭
• 정상적으로 Hot Reload 및 빌드가 완료되면 문제 해결

---

4. 최종 결과 (Outcome)

• __has_feature 매크로 오류 제거
• Visual Studio Toolchain 정상 인식
• 프로젝트 및 UE 에디터에서 C++ 빌드 정상 작동
• VS2026과의 충돌 문제 해결

---

5. 재발 방지 가이드 (Prevention)

5.1 VS 미지원 버전 제거 금지

• 언리얼 엔진은 항상 특정 VS 정식 릴리즈만 지원
• Preview 버전(VS2025/2026)은 절대 단독 사용 금지

5.2 VS 삭제 전 체크리스트

• UE 공식 문서에서 지원하는 Toolchain 버전 확인
• 기존 VS 버전 삭제 금지
• 새 버전은 병행 설치 후 정상동작이 확인될 때만 유지

---

https://dev.epicgames.com/documentation/en-us/unreal-engine/setting-up-visual-studio-development-environment-for-cplusplus-projects-in-unreal-engine

Unreal Engine 5.7 and Visual Studio 2026!!

VS 2026 의 문제일까요? - 인프런 | 커뮤니티 질문&답변