Module not found: Can't resolve '...' 해결

증상

빌드 또는 실행 시 다음 오류로 멈춥니다.

Module not found: Error: Can't resolve './utils' in '/src/components'

원인

import가 가리키는 모듈을 번들러가 찾지 못했습니다. 흔한 경우:

• 경로 오타·대소문자 불일치 (./Utils vs ./utils — 리눅스/배포 환경은 대소문자 구분)
• 확장자나 폴더 구조 변경 후 경로 미수정
• 패키지를 설치하지 않음 (node_modules에 없음)
• 경로 별칭(@/...)이 설정되지 않음

해결

1) 상대 경로·대소문자 확인

// 파일 실제 위치와 정확히 일치해야 함 (대소문자 포함)
import { format } from './utils/date';

내 코드 모듈이면 ./ 또는 ../로 시작해야 합니다. 이게 빠지면 패키지로 간주됩니다.

2) 패키지면 설치

npm install 패키지명

오류 메시지의 모듈명이 외부 패키지(react-icons 등)인데 못 찾는다면 설치가 누락된 것입니다.

3) 경로 별칭(@/) 설정

tsconfig.json에 paths가 있어야 @/를 인식합니다.

{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } }

로컬에선 되는데 배포에서만 깨진다면 99% 대소문자 불일치입니다. macOS/Windows는 대소문자를 구분하지 않지만 배포 서버(Linux)는 구분합니다.