문제가 생기면 먼저 내가 수정한 소스와 도구가 만든 생성물을 분리해서 본다
화면 오류, 설치 오류, 빌드 오류는 서로 다른 위치에서 출발한다. 위치를 나누면 원인 추적이 빨라진다.
| 분류 | 대표 파일 | 문제가 보이는 신호 | 대응 |
|---|---|---|---|
| 내가 쓴 소스 | src/app/page.tsx, layout.tsx | 화면 문구, 컴포넌트, 라우팅 오류 | 최근 수정 코드와 import 확인 |
| 전역 스타일 | globals.css | 전체 화면 여백, 색, 폰트 변화 | 전역 선택자와 class 충돌 확인 |
| 설정 | package.json, tsconfig.json | 명령 실패, alias 실패, 타입 오류 | scripts, paths, 의존성 확인 |
| 설치 결과 | node_modules, lockfile | 패키지 import 실패 | install 재실행, lockfile 충돌 확인 |
| 빌드 cache | .next | 이전 화면이 남거나 빌드 산출 오류 | 서버 재시작 또는 cache 재생성 |