AI 코드가 깨졌을 때: 디버깅 입문
AI가 쓴 코드가 한 번에 맞는 건 아니다. 에러를 읽고 범위를 좁히고 올바른 단서를 AI에 돌려주기—초보자를 위한 체계적 디버깅.
한 문장으로
디버깅은 찍기가 아니라 '범위를 좁히고 올바른 단서를 AI에 돌려주는' 것. 이걸 익히면 AI가 고칠 수 있다.
만들 결과물
깨진 코드에 대한 정해진 절차: 에러 읽는 법, 범위 좁히는 법, AI에 줄 단서 만드는 법.
깨지는 건 정상
AI가 쓴 코드가 한 번에 맞는 건 아닙니다—당신 탓이 아니라 정상입니다. 차이는, 디버깅할 수 있는 사람은 고치고, 못 하는 사람은 AI에게 '다시'만 반복하며 더 엉키게 만든다는 것. 디버깅은 영감이 아니라 배울 수 있는 체계적 방법입니다.
1단계: 에러 메시지를 읽는다 (건너뛰지 않기)
깨지면 화면이나 브라우저의 **Console(콘솔)**에 빨간 에러가 뜹니다. 초보자가 가장 흔히 하는 실수는 빨간 글씨에 당황해 바로 AI에 '깨졌어'라고 붙이는 것. 먼저 직접 읽으세요: 에러는 보통 어느 파일·몇 번째 줄·무슨 문제인지 바로 알려줍니다. 이해 못 해도 괜찮으니 전체를 받아두세요.
2단계: 범위를 좁힌다 (이분법)
전체를 한 번에 노려보지 마세요. 물어보세요: "마지막으로 된 게 언제? 이번에 뭘 바꿨지?" 의심 범위를 반으로 자릅니다—의심스러운 부분을 빼거나 주석 처리해 여전히 깨지는지 확인. 작은 범위에서 안정적으로 재현되면 원인은 금방 잡힙니다.
3단계: 올바른 단서를 AI에 돌려준다
AI가 못 고치는 건 대개 준 정보가 너무 적어서입니다. 다음 셋을 한 번에 주면 적중률이 크게 오릅니다:
- 에러 메시지 전문('깨졌어'가 아니라 전체).
- 재현 절차: 무엇을 하면 발생하는지, 기대와 실제.
- 이미 시도한 것: AI가 효과 없던 방법을 반복하지 않도록.
흔한 함정
- 한 번에 너무 많이 바꾸기: 깨졌을 때 어느 변경이 원인인지 모릅니다. 한 번에 한 곳, 바꾸면 테스트.
- Console을 열지 않기: 많은 에러는 콘솔에만 뜨고 화면은 '그냥 이상해' 보일 뿐.
- 무한 '다시': AI가 계속 못 고치면 한 걸음 물러나 직접 범위를 좁히고 새 단서를 주는 편이 낫습니다.
다음 단계
- 바꾸기 전에 버전을 저장해 되돌릴 수 있게: Git으로 코드 관리하기
- AI와 더 잘 협업하기: AI 협업 플레이북
자주 묻는 질문
AI가 같은 버그를 계속 못 고치면?
무한 ‘다시’에 빠지지 마세요. 한 걸음 물러나 직접 범위를 좁히고(이분법으로 원인 구간 찾기), ‘에러 전문 + 재현 절차 + 시도한 것’을 한 번에 주세요. 정보가 구체적일수록 AI가 잘 고칩니다. ‘아직도 깨졌어’만으로는 거의 제자리.
에러 메시지를 못 읽어도 디버깅할 수 있나요?
가능합니다. 한 글자까지 이해할 필요는 없지만 **전문**을 받아 AI에 주세요—보통 읽을 수 있습니다. 에러 자체보다 유용한 건 ‘어떻게 하면 발생·기대·실제’의 재현 절차입니다. 함께 주면 적중률이 가장 높습니다.
참고 자료
- Chrome DevTools — Google
- JavaScript error reference — MDN — Mozilla