요약 슬라이드
트러블슈팅 가이드
바이브코딩 중 만나는 각종 에러(경고등)를 해결하기 위한 응급 처치 매뉴얼입니다.
기본 대응 3원칙
- 에러 읽기: 무엇이(What), 어디서(Where), 왜(Why) 문제인지 시스템의 말을 듣습니다.
- 전체 전달: 에러 메시지를 요약하지 말고 통째로 복사해서 AI에게 보여줍니다.
- 우회하기: 도저히 안 되면 "다른 방법으로 구현해줘"라고 우회로를 찾습니다.
자주 만나는 경고등 (TOP 7)
| 에러 상황 | 원인 | 해결 방법 |
|---|---|---|
| npm install 실패 | 버전 충돌 또는 권한 부족 | 에러 전문을 AI에게 주고 --legacy-peer-deps 옵션 등 문의 |
| 포트 사용 중 (3000) | 이전 서버가 아직 켜져 있음 | 터미널을 닫고 다시 열거나, AI에게 해당 포트 킬(Kill) 요청 |
| 모듈 없음 (Cannot find) | 패키지 미설치 또는 경로 오타 | AI에게 파일 구조를 보여주며 재설치 또는 오타 수정 요청 |
| 화면 안 나옴 (흰 화면) | 코드 논리 오류 | F12(개발자 도구) 콘솔 탭의 빨간 에러 메시지를 복사해 전달 |
| 수정사항 반영 안 됨 | 서버 미재시작 또는 브라우저 캐시 | 강제 새로고침(Cmd+Shift+R) 및 개발 서버 재시작 |
| 배포 실패 (Vercel) | 배포 환경 설정 오류 | Vercel 'Build Logs'의 에러 부분을 복사해 AI에게 진단 요청 |
| Git 충돌 (Merge Conflict) | 작업 내역 간의 엉킴 | AI에게 충돌 파일 내용을 보여주고 "하나로 합쳐줘"라고 요청 |
AI에게 에러를 잘 전달하는 공식
정확한 진단을 위해 아래 구성으로 말해 보세요.
- [상황]: "방명록 버튼을 눌렀을 때"
- [증상]: "화면이 멈추고 이런 빨간 글씨가 나와"
- [에러]: (에러 메시지 복사 붙여넣기)
- [시도]: "서버는 껐다 켜봤어"
최후의 수단: "리셋"
도저히 실타래가 풀리지 않을 때는 이렇게 말하세요.
"이 기능을 처음부터 다시 만들어줘. 이번엔 가장 단순한 방법으로 해줘."