18강 / 20강

막혔을 때 — 오류를 읽는 법

오류 메시지는 꾸중이 아니라 안내입니다

코드를 쓰면 반드시 오류가 납니다. 잘하는 사람도 똑같이 냅니다 — 다만 빨리 읽습니다.

1. 맨 아래 줄부터 읽는다 — 오류의 종류와 이유가 거기 있다

2. 그 위에서 내 코드의 줄 번호를 찾는다

3. 가운데의 남의 코드는 대개 건너뛴다

거꾸로 읽는 것이 요령입니다. 위쪽은 "여기를 거쳐 왔다" 는 경로일 뿐이에요.

고등학생오류는 꾸중이 아니라 안내입니다

코드를 쓰면 반드시 오류가 납니다. 20년 한 사람도 똑같이 냅니다 — 다만 빨리 읽습니다.

차이는 오류를 안 내는 것이 아니라 빨리 고치는 것이다

먼저 마음가짐

빨간 글씨가 쏟아지면 내가 뭘 크게 잘못했나 싶습니다. 그렇지 않아요.

오해	실제
"컴퓨터가 화났다"	"여기가 이상해요" 라고 알려 주는 것
"나는 못하는구나"	모두가 하루에 수십 번 본다

비유 — 내비게이션

"경로를 벗어났습니다" 는 비난이 아니죠. 정보입니다. 그리고 그 말이 없으면 더 헤맵니다.

오류 메시지가 안 나오는 게 더 무서워요 — 2강·6강·10강에서 계속 본 조용히 틀리는 경우요.

오류가 났다는 건 컴퓨터가 이상함을 알아챘다는 뜻이다

읽는 순서 — 거꾸로

순서	어디를	무엇이 있나
①	맨 아래 줄	오류의 종류와 이유
②	그 위	내 코드의 줄 번호
③	가운데	남의 코드 — 대개 건너뛴다

위쪽은 "여기를 거쳐 왔다" 는 경로일 뿐이다

초보자는 맨 위부터 읽다가 모르는 파일 이름이 잔뜩 나와 겁먹습니다. 맨 아래부터 읽으면 대개 한 줄로 끝나요.

다섯 가지가 초보자 오류의 대부분입니다.

Python 브라우저에서 실행

# 흔한 오류 다섯 가지를 일부러 내 본다
자료 = {"DDX54": 12.4, "CD47": 8.9}
목록 = [1, 2, 3]

시험 = [
    ("KeyError",   lambda: 자료["TP53"]),
    ("IndexError", lambda: 목록[10]),
    ("TypeError",  lambda: "12.4" + 5),
    ("ValueError", lambda: float("열두점사")),
    ("ZeroDivisionError", lambda: 1 / 0),
]

for 이름, f in 시험:
    try:
        f()
    except Exception as e:
        print(f"{type(e).__name__:<20}{e}")

print()
print("무슨 뜻인가:")
print("  KeyError          딕셔너리에 그 열쇠가 없다 → .get() 을 쓰거나 in 으로 확인")
print("  IndexError        리스트가 그만큼 길지 않다 → len() 을 확인")
print("  TypeError         자료형이 안 맞는다 → float()/int() 로 바꿨는지 확인")
print("  ValueError        형은 맞는데 값이 이상하다 → 파일에 빈 칸이나 NA 가 있나")
print("  ZeroDivisionError 0 으로 나눴다 → 분모가 0 일 때를 미리 막는다")

고등학생다섯 가지가 대부분입니다

코드가 흔한 오류 다섯 가지를 일부러 냅니다. 좋은 방법이에요 — 안전한 곳에서 미리 만나 보는 거죠.

오류	무슨 뜻	어떻게 고치나
`KeyError`	딕셔너리에 그 열쇠가 없다	`.get()` 을 쓰거나 `in` 으로 확인
`IndexError`	리스트가 그만큼 길지 않다	`len()` 을 확인
`TypeError`	자료형이 안 맞는다	`int()`/`float()` 로 바꿨나 확인
`ValueError`	형은 맞는데 값이 이상하다	파일에 빈 칸이나 NA 가 있나
`ZeroDivisionError`	0 으로 나눴다	분모가 0 일 때를 미리 막는다

지금까지 배운 것과 연결됩니다

KeyError — 5강의 .get() 이 이걸 막으려고 있는 것
TypeError — 2강의 "3" + 5 문제
ValueError — 9강의 float("NA") 문제
ZeroDivisionError — 7강의 빈 서열 문제

배운 것들이 왜 필요했는지 여기서 한꺼번에 드러난다

TypeError 와 ValueError 의 차이

헷갈리기 쉬운데, 이렇게 구별하세요.

	비유
TypeError	물을 넣어야 할 곳에 돌을 넣었다 — 종류가 틀림
ValueError	물을 넣긴 했는데 바닷물이었다 — 종류는 맞고 값이 틀림

오류 이름이 곧 힌트입니다

영어를 그대로 읽으면 됩니다 — KeyError(열쇠 문제), IndexError(번호 문제), TypeError(종류 문제), ValueError(값 문제).

이름만 봐도 어디를 볼지 정해집니다.

막혔을 때 하는 세 가지

🖨️

찍어 본다

print(type(x), len(x))
내 짐작이 맞나

✂️

줄여 본다

2만 줄 대신 다섯 줄로
같은 오류가 나나

🔍

검색한다

오류 마지막 줄을 그대로
붙여 넣고 찾는다

둘째가 특히 값을 합니다. 자료를 손으로 만든 다섯 줄로 줄이면 문제가 자료 탓인지 코드 탓인지 곧 갈립니다.

고등학생막혔을 때 하는 세 가지

본문의 세 가지가 실전 그 자체입니다. 하나씩 풀어 봅시다.

① 찍어 본다

print(type(x), len(x)) — 내 짐작이 맞나

대부분의 버그는 "내가 생각한 것과 다른 것이 들어 있어서" 생깁니다.

내 생각	실제
숫자 리스트	글자 리스트 (9강)
100줄	0줄 — 거르기가 다 걸렀다
(2만, 100)	(100, 2만) — 뒤집혔다 (10강)

찍어 보면 1초에 알 수 있는 걸 한 시간 고민하는 게 초보자의 가장 흔한 낭비입니다.

② 줄여 본다

2만 줄 대신 다섯 줄로 — 같은 오류가 나나

자료를 줄이면 실행이 빨라지고, 무엇보다 눈으로 확인할 수 있게 됩니다.

비유하자면 — 방 전체에서 열쇠를 찾는 대신 서랍 하나씩 뒤지는 거예요. 범위를 좁히는 겁니다.

③ 검색한다

오류 마지막 줄을 그대로 붙여 넣고 찾는다

이게 부끄러운 일이 아닙니다. 전문 개발자도 하루에 수십 번 합니다.

다만 요령이 있어요 —

내 파일 이름·변수 이름은 빼고 검색한다 (남과 다르니까)
오류 종류 + 라이브러리 이름으로 검색한다 (예: "pandas ValueError could not convert")

그리고 네 번째 — 남에게 설명해 본다

유명한 요령이 있습니다. 고무 오리 디버깅이라고 해요.

책상 위 인형에게 코드를 한 줄씩 설명합니다. 그러다 보면 말하는 도중에 스스로 답을 찾습니다.

설명하려면 정리해야 하고, 정리하면 구멍이 보인다

공부에도 그대로 쓰이는 방법이죠 — 남을 가르쳐 보면 안다고 착각했던 게 드러납니다.

가장 무서운 오류는 <b>오류가 안 나는 오류</b>입니다.

Python 브라우저에서 실행

import pandas as pd, numpy as np

# 실무에서 가장 자주 겪는 것 — 파일의 빈 칸(NaN)
df = pd.DataFrame({
    "gene":   ["DDX54", "CD47", "CD38", "MYC"],
    "log2fc": [0.62, np.nan, 0.44, 0.71],
    "pvalue": [0.008, 0.021, np.nan, 0.002],
})
print(df)
print()

print("빈 칸이 있나:")
print(df.isna().sum().to_string())
print()

# NaN 은 어떤 비교에도 False 다 — 조용히 빠진다
유의 = df[(df["log2fc"].abs() > 0.3) & (df["pvalue"] < 0.05)]
print(f"거른 결과 {len(유의)}줄 — 4줄 중 2줄이 사라졌습니다:")
print(유의.to_string(index=False))
print()
print("NaN 이 있는 줄이 조용히 빠진 것입니다. 오류도 경고도 없이요.")
print("→ 거르기 전에 .isna().sum() 으로 확인하는 습관이 이것을 막습니다.")

고등학생오류를 안 내는 게 목표가 아닙니다

18강을 마치며 한 가지만 더.

목표는 오류를 안 내는 것이 아니라
오류를 빨리 찾고 고치는 것이다

왜 이 구별이 중요한가

오류를 안 내려고 하면 아무것도 안 하게 됩니다. 확실한 것만 쓰고, 새로운 걸 안 시도하죠.

그런데 프로그래밍은 시도해 보는 일입니다. 돌려 보고 고치는 것이 정상적인 과정이에요.

비유 — 자전거 배우기

넘어지지 않으려고 안 타면 영영 못 탑니다. 넘어지면서 배우는 거죠.

다만 크게 안 다치게 하는 요령은 있습니다 — 헬멧을 쓰고, 넓은 데서 연습하고요.

코드에서 '헬멧' 에 해당하는 것

습관	무엇을 막아 주나
작게 나눠 자주 실행	어디서 틀렸는지 바로 안다
결과의 개수를 확인	조용히 틀린 것을 잡는다
원본을 안 덮어쓴다	망쳐도 되돌릴 수 있다
함수에 가장자리 처리	7강 — 빈 값·0 나누기

두 번째 — 개수 확인 — 이 강의가 가장 여러 번 말한 것이다

6강, 8강, 10강, 11강, 12강에서 계속 나왔죠. 가장 싸고 가장 잘 듣는 검증이기 때문입니다.

그리고 이 페이지에서는

마음껏 망가뜨려도 됩니다. ↺ 버튼이 원래대로 되돌리고, 여러분 컴퓨터에는 아무 영향이 없어요.

이렇게 안전하게 실패할 수 있는 곳에서 많이 실패해 두는 게 가장 빨리 배우는 길입니다.

🤔 확인 문제

파이썬 오류 메시지를 읽을 때 가장 먼저 볼 곳은?