가장실용적인 디버깅 워크북 - 인프런

버그 앞에서 멍하니 화면만 바라본 적이 있습니다.

에러 메시지를 구글에 붙여넣고, 나온 답을 하나씩 따라 해보고, 안 되면 또 다른 답을 찾고. 그렇게 몇 시간이 지나도 원인은 모릅니다. 그냥 어딘가를 건드렸더니 됐습니다. 왜 됐는지는 모릅니다.

다음 날, 비슷한 버그가 또 나타납니다.

디버깅은 감이 아닙니다.

경력이 쌓일수록 버그를 빨리 잡는 개발자들에게는 공통점이 있습니다. 무작위로 코드를 고치지 않습니다. 순서가 있고, 질문이 있고, 검증하는 방식이 있습니다.

이 워크북은 그 방식을 10가지 기술로 정리한 것입니다. 읽고 끝나는 책이 아닙니다. 지금 겪고 있는 실제 버그에 직접 써보는 책입니다.

기술 01. 재현 버그를 재현할 수 없으면 고칠 수 없습니다. 최소 재현 케이스(MRC)를 만드는 4단계를 익힙니다.

기술 02. 가설 무작위 수정을 멈추고 과학적으로 좁혀갑니다. 좋은 가설의 두 가지 조건과 검증 사이클을 배웁니다.

기술 03. 이분법 10,000줄 코드에서 14번 안에 버그 위치를 찾는 방법입니다. git bisect 활용법도 포함합니다.

기술 04. 로그 코드 안에 살아있는 눈을 만드는 방법입니다. 타임스탬프, 레벨 구분, 어디서 무엇을 찍을지 설계합니다.

기술 05. 스택 트레이스 에러가 직접 알려주는 위치를 읽는 법입니다. 아래에서 위로 읽는 이유와 내 코드를 먼저 찾는 방법을 배웁니다.

기술 06. 상태 의심하기 코드가 같은데 결과가 다를 때의 접근법입니다. 캐시, 전역 상태, 환경 차이를 하나씩 고정해 원인을 격리합니다.

기술 07. 타이밍 버그 가끔 발생하는 버그를 잡는 방법입니다. 경쟁 조건, 순서 의존성, 타임존 차이까지 다룹니다.

기술 08. 장애 대응 긴박한 상황에서 패닉 없이 체계적으로 움직이는 법입니다. 완화 → 진단 → 해결 흐름을 익힙니다.

기술 09. 버그 일지 같은 버그를 두 번 만나지 않는 방법입니다. 검색 가능한 일지를 작성하는 구조를 배웁니다.

기술 10. 도움 요청 30분 룰과 고무 오리 디버깅, 좋은 질문의 4가지 요소를 익힙니다.

각 기술은 세 파트로 이루어져 있습니다.

핵심 개념 — 2분 안에 읽을 수 있는 원리 설명입니다.

실습 워크시트 — 직접 채워가며 익히는 공간입니다. 지금 겪고 있는 버그에 바로 적용할 수 있습니다.

실무 체크리스트 — 오늘 바로 적용할 수 있는 항목들입니다.

부록으로 버그 해결 플로우차트, 간헐적 버그 대응 체크리스트, 버그 유형별 첫 확인 지점 표, MRC 체크리스트를 제공합니다.

"이론만 잔뜩 있는 책 아닌가요?" 이 워크북은 읽기만 하면 아무것도 남지 않습니다. 각 기술마다 지금 겪고 있는 버그에 직접 채울 수 있는 워크시트가 있습니다. 실제로 써봐야 내 것이 됩니다.

"입문자도 볼 수 있나요?" 첫 번째 버그를 만난 날부터 쓸 수 있습니다. 특정 언어나 프레임워크를 전제하지 않습니다. 모든 기술은 언어에 상관없이 적용됩니다.

"실제 현업에서도 쓰이는 방법인가요?" 이 워크북에 담긴 기술들은 코드 리뷰, 온콜 대응, 팀 디버깅 세션에서 실제로 사용됩니다. 이분법은 git bisect로, 로그 설계는 프로덕션 모니터링으로, 버그 일지는 팀 위키로 이어집니다.

디버깅을 잘한다는 것은 버그를 안 만드는 게 아닙니다.

버그를 만났을 때 당황하지 않고, 어디서부터 시작할지 알고, 팀원에게 "여기까지 확인했습니다"라고 말할 수 있는 것입니다.

이 워크북이 그 시작점이 되길 바랍니다.