내배캠 TIL

[내배캠 TIL 260205] Unreal Enhanced Input 헤더 인식 이슈

xodn246 2026. 2. 5. 21:08

UE 5.6.1 환경에서 Enhanced Input을 사용하던 중
#include "EnhancedInputComponent.h" 구문에서 Visual Studio가 “파일 소스를 열 수 없습니다”라는 오류를 표시했다.

다만 이상하게도 프로젝트는 정상적으로 빌드되고 실행까지 잘 되는 상황이었다.


처음에 의심했던 부분

가장 먼저 아래 항목들을 확인했다.

  • 헤더 파일명 오타 여부
  • Build.cs에 EnhancedInput 모듈이 포함되어 있는지
  • Enhanced Input 플러그인이 실제로 활성화되어 있는지

모두 정상 상태였고, 컴파일 에러도 발생하지 않았다.


원인 정리

결론적으로 이 문제는 Visual Studio IntelliSense 인식 문제였다.

  • Unreal Build Tool은 Enhanced Input 헤더를 정상적으로 찾음
  • Visual Studio는 플러그인 기반 모듈의 include 경로를 제대로 인식하지 못함
  • 그 결과 IDE 상에서만 오류 표시가 나타남

UE 5.3 이후부터
Enhanced Input이나 GAS처럼 플러그인에 포함된 헤더를 사용할 때 이와 비슷한 현상이 종종 발생한다고 한다.

즉, 실제 코드나 설정 문제라기보다는 IDE와 빌드 시스템 간의 해석 차이로 인한 현상이다.


확인해본 내용

  • UE 버전: 5.6.1
  • Enhanced Input 플러그인 활성화 상태
  • Build.cs에 EnhancedInput 모듈 추가됨
  • 빌드 및 실행 정상

또한 엔진 경로에서 EnhancedInputComponent.h 파일이 실제로 존재하는 것도 확인했다.


대응 방법

  • 빌드가 정상이라면 그대로 사용해도 문제 없음
  • include 경로나 코드를 수정할 필요는 없음
  • 캐시 삭제 후 재생성으로 IDE 오류가 완화되기도 함
  • Rider for Unreal을 사용할 경우 이런 문제가 거의 발생하지 않음

Visual Studio를 계속 사용할 경우 완전히 사라지지 않을 수도 있는 점은 감안해야 한다.


정리

  • EnhancedInputComponent.h 관련 오류는 실제 컴파일 에러가 아님
  • UE5 + Enhanced Input 환경에서 자주 보이는 IntelliSense 문제
  • IDE의 경고보다는 빌드 결과를 기준으로 판단하는 것이 중요