TypeScript - 모듈에 대한 선언 파일을 찾을 수 없습니다 해결법

보통 우리는 npm에서 필요한 모듈을 설치한 다음 필요한 컴포넌트에서 해당 모듈을 import해서 사용합니다.

하지만 TS에서는 분명히 모듈을 설치했는데도 아래와 같은 에러가 발생하는 경우가 있다.

 

내가 설치를 안했나... 해서 다시 설치도 해보고, 실수로 다른 모듈을 설치했나.... 해서 다시 설치 했는데 결국 실패했다.

📌 본인이 설치한 모듈이 JS 환경에서 사용가능한 형태만 지원하고, 해당 모듈 개발자가 TS에서 사용가능한 형태는 지원하지 않아서 아무리 설치해도 모듈을 찾을 수 없다는 오류가 발생했던 것이다.

이러한 오류를 해결하는 방법은 간단했다.

d.ts 파일 생성해서 전역에 선언해주기

 

src 폴더 내에 types 폴더를 생성해주고 모듈명과 똑같은 이름으로 d.ts파일을 생성해준다.

위 모듈을 예시로 들면

 

react-gtm-module.d.ts 파일을 생성해주고 내부에

declare module 'react-gtm-module';

 

해당 코드를 넣어주고 import해주면 오류가 해결된다.