버그 찾기 첫걸음

지난 글에서는 try-except로 예외를 처리하는 방법을 살펴봤어요. 그런데 예외를 잡았다고 문제가 저절로 해결되지는 않죠. 화면에 에러가 나오지 않아도 결과가 이상할 수 있고, 어디서 잘못됐는지 한참 헤맬 수도 있어요. 오늘은 그럴 때 버그를 찾고 고치는 디버깅의 기본 흐름을 이야기해볼게요.

디버깅은 범인을 좁혀 가는 과정

디버깅은 예상과 실제를 비교하며 문제를 좁혀 가는 과정

디버깅은 버그를 마법처럼 지우는 작업이 아니에요. 코드가 어떻게 동작할 거라고 예상했는지, 실제로는 어떤 결과가 나왔는지 비교하면서 문제가 생긴 지점을 좁혀 가는 일입니다.

예를 들어 장바구니 가격을 더하는 코드가 있다고 해볼게요. 합계가 예상보다 작다면, 계산식 전체를 의심하기 전에 입력값과 각 단계의 합계를 확인하면 훨씬 빨리 단서를 얻을 수 있어요.

먼저 아래처럼 상황을 정리해보세요.

  • 기대한 결과: 상품 두 개의 가격을 더한 값
  • 실제 결과: 화면에 표시된 합계
  • 재현 방법: 어떤 값을 넣었을 때 문제가 생기는지

문제가 매번 같은 조건에서 나타나는지도 중요해요. 재현 방법을 알면 코드를 고친 뒤에도 해결됐는지 확인할 수 있거든요. 음... 재현되지 않는 버그를 쫓다 보면, 어제의 나와 오늘의 내가 서로 다른 코드를 보고 있는 기분이 들기도 합니다.

먼저 print로 값의 흐름을 확인해요

print문으로 프로그램 각 단계의 값을 살펴보는 모습

가장 간단한 디버깅 방법은 print()로 중간값을 확인하는 거예요. 개발하다 보면 “여기 값이 이상할 리가 없는데?”라고 생각한 자리에 진짜 이상한 값이 있는 경우가 꽤 있어요. 솔직히 말하면, 저도 그런 순간에 코드를 탓하기 전에 제 예상을 먼저 의심하게 됩니다.

prices = [1200, 2500]

total = 0
for price in prices:
    print("더하기 전:", total, "현재 가격:", price)
    total += price
    print("더한 뒤:", total)

print("최종 합계:", total)

출력을 보면 반복문이 돌 때 total과 price가 어떻게 바뀌는지 알 수 있어요. 값이 바뀌는 순간을 확인하면 계산식 문제인지, 입력 데이터 문제인지 판단하기 쉬워집니다.

print()를 쓸 때는 중요한 지점에 짧은 설명을 붙여보세요. 값만 여러 개 찍으면 나중에는 “이 숫자가 어디서 나온 거지?” 하고 또 추적하게 되거든요. 문제를 찾은 뒤에는 확인용 출력문을 정리해두는 것도 잊지 마세요.

디버거로 한 줄씩 실행해보기

디버거에서 줄 단위로 실행하며 변수 값을 확인하는 화면

print()만으로 부족하면 IDE나 편집기에 들어 있는 디버거를 써볼 수 있어요. 디버거는 프로그램을 멈춰 세운 뒤, 코드를 한 줄씩 실행하고 그 순간의 변수 값을 보여주는 도구예요.

시작점은 보통 중단점입니다. 확인하고 싶은 줄 옆을 눌러 중단점을 설정하고 디버그 실행을 하면, 프로그램이 그 줄에 도착했을 때 잠시 멈춰요. 그다음 한 줄씩 진행하면서 변수 값이 언제 예상과 달라지는지 살펴보면 됩니다.

처음에는 버튼 이름이 낯설 수 있어요. 보통은 이런 순서로 사용합니다.

  1. 문제를 재현하는 입력을 준비해요.
  2. 의심되는 줄에 중단점을 설정해요.
  3. 디버그 모드로 실행해요.
  4. 한 줄씩 이동하며 변수 값을 확인해요.
  5. 문제가 시작되는 지점을 찾으면 원인을 고쳐요.

디버거는 변수를 구경하는 데서 끝나지 않아요. 함수 안으로 들어가 볼 수도 있고, 실행을 이어 가거나 다음 중단점까지 건너뛸 수도 있어요. 다만 기능을 한꺼번에 외우려 할 필요는 없습니다. 일단 멈추기, 한 줄 실행하기, 변수 보기만 써도 도움이 돼요.

수정은 작게, 확인은 다시

작은 수정 뒤에 같은 조건으로 다시 확인하는 과정

원인을 찾았다고 생각하면 한 번에 여러 곳을 고치기보다 한 가지씩 수정해보세요. 여러 변경을 동시에 하면 결과가 달라져도 무엇이 효과가 있었는지 알기 어려워요.

고친 뒤에는 처음에 문제가 생겼던 조건을 다시 실행해보세요. 그리고 가능하면 정상적으로 동작해야 하는 다른 조건도 함께 살펴보면 좋아요. 예를 들어 가격 합계를 고쳤다면 상품이 하나일 때, 여러 개일 때, 목록이 비어 있을 때도 확인할 수 있겠죠.

제가 자주 쓰는 흐름은 이렇습니다.

  • 문제가 생기는 입력을 정리한다.
  • 중간값을 보며 원인을 좁힌다.
  • 작은 수정 하나를 적용한다.
  • 같은 입력으로 다시 실행한다.
  • 주변 조건도 확인하고 임시 출력을 치운다.

어? 이렇게 써놓고 보면 꽤 단순하죠. 하지만 급할수록 코드 여기저기를 한꺼번에 바꾸고 싶어져요. 그럴 때일수록 수정 전후를 비교할 수 있게 천천히 움직이는 편이 결국 덜 돌아갑니다.

버그를 만났을 때 기억할 것

  • 에러가 없어도 결과가 틀리면 디버깅이 필요해요.
  • 재현 가능한 입력과 기대 결과를 먼저 정리해요.
  • print()는 값의 흐름을 빠르게 확인할 때 유용해요.
  • 디버거는 실행을 멈추고 변수와 코드 흐름을 살펴볼 때 좋아요.
  • 수정은 작게 하고, 고친 뒤에는 같은 조건으로 다시 확인해요.

디버깅은 특별한 재능보다 차근차근 확인하는 습관에 가까워요. 익숙해지면 막연히 코드를 바라보는 시간은 줄고, 어디를 살펴볼지 감이 잡히기 시작합니다. 다음 글에서는 디버깅 중 자주 마주치는 에러 메시지를 읽는 법을 다뤄볼게요. 메시지에서 어떤 정보를 먼저 찾으면 좋은지도 함께 정리해보겠습니다.

AIWD 소모임AI 자동화 오픈톡