TypeScript타입
TS2307 Cannot find module — 타입 선언을 찾지 못함
TS2307: Cannot find module '<module>' or its corresponding type declarations
한 줄 해결: 컴파일러가 모듈이나 그 타입 선언을 못 찾은 것으로, 패키지·@types 설치 또는 tsconfig paths 정렬로 해결합니다.
이런 증상일 때
import 한 모듈에 TS2307 빨간 줄이 뜹니다. 런타임은 되는데 타입만 못 찾는 경우(@types 누락)와, 경로 alias 가 안 잡힌 경우 둘 다 이 코드로 나옵니다.
원인
- 패키지에 내장 타입이 없고 @types/패키지 도 설치 안 됨
- tsconfig 의 paths/baseUrl alias 가 실제 구조와 불일치
- moduleResolution 설정이 패키지의 exports 맵과 안 맞음
해결 방법
1
@types 설치
커뮤니티 타입이 있는 패키지는 @types 를 devDependencies 로 설치합니다.
npm install -D @types/<패키지>2
paths alias 동기화
tsconfig 의 baseUrl·paths 가 import alias 와 일치하는지 확인합니다.
// tsconfig.json
"baseUrl": ".", "paths": { "@/*": ["src/*"] }3
타입 없는 모듈 선언
타입이 아예 없는 모듈은 d.ts 에 모듈 선언을 추가해 무시합니다.
// global.d.ts
declare module 'no-types-pkg'💡 예방: 새 패키지 설치 시 타입 내장 여부를 확인하고, 없으면 @types 를 함께 설치하세요.
TypeScriptTS2307@typestsconfigpaths