·오류 문구 사전

tsc · 빌드·타입

오류 문구

error TS2307: Cannot find module 'lodash' or its corresponding type declarations.

무슨 뜻인가

tsc가 그 모듈의 자리도, 그 모듈의 타입 선언도 찾지 못했다는 뜻이고, 문구가 둘을 함께 말하는 것이 중요합니다 — 패키지가 아예 없을 수도 있고, 패키지는 설치되어 있는데 타입만 없을 수도 있습니다. 설치는 했는데 이 말이 나오면 타입 쪽이니 npm i -D @types/lodash처럼 짝이 되는 타입 패키지를 넣으면 되고, 최근 패키지들은 타입을 안에 담고 있어 @types가 아예 없는 경우도 많습니다. 상대 경로 import에서 이 오류가 나면 대소문자와 tsconfig의 paths를 보세요 — 자기 파일을 가리키는 경로는 @types와 아무 상관이 없습니다.

고치는 명령

npm i -D @types/lodash
내는 도구
tsc
빌드·타입
10

빌드가 내는 오류는 실행 전에 도구가 거절한 것이라 그 자리에서 프로그램을 망가뜨리지는 않지만 대신 두 가지를 물어봅니다 — 타입이나 경로를 실제 모양에 맞게 고칠 것인가, 아니면 as any나 인용 부호 하나로 그 줄만 통과시킬 것인가 — 그리고 대소문자와 확장자, 환경 변수처럼 내 컴퓨터에서만 맞는 것들은 여기서 처음 드러납니다.

오류 문구를 읽는 법

  • 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
  • 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
  • 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
  • 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
  • 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.

자주 묻는 질문

Q. error TS2307: Cannot find module 'lodash' or its corresponding type declarations. 는 무슨 뜻인가요?

tsc가 그 모듈의 자리도, 그 모듈의 타입 선언도 찾지 못했다는 뜻이고, 문구가 둘을 함께 말하는 것이 중요합니다 — 패키지가 아예 없을 수도 있고, 패키지는 설치되어 있는데 타입만 없을 수도 있습니다. 설치는 했는데 이 말이 나오면 타입 쪽이니 npm i -D @types/lodash처럼 짝이 되는 타입 패키지를 넣으면 되고, 최근 패키지들은 타입을 안에 담고 있어 @types가 아예 없는 경우도 많습니다. 상대 경로 import에서 이 오류가 나면 대소문자와 tsconfig의 paths를 보세요 — 자기 파일을 가리키는 경로는 @types와 아무 상관이 없습니다.

Q. 어떻게 고치나요?

npm i -D @types/lodash — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.

Q. 어느 도구가 내는 오류인가요?

tsc입니다. 빌드·타입 갈래에 있고, 문구는 11낱말입니다.

같이 나는 오류