본문으로 바로 가기
인생은 여울여울

홈 / 글 모아보기

파이썬 오류 메시지 읽기: 마지막 줄에서 원인과 위치 찾기

파이썬 오류 메시지가 길면 마지막 줄의 오류 이름과 설명부터 읽고, 그 위의 파일 이름과 줄 번호로 돌아가세요. 해당 줄에서 쓰는 값이 어디서 왔는지 확인한 뒤 한 곳만 고쳐 다시 실행하면 됩니다. 아래는 Python 3 파일을 실행할 수 있는 분을 위한 실습이며, 설치나 편집기 설정은 다루지 않습니다.

2026년 9월 16일 macOS의 Python 3.14.4에서 직접 실행한 작은 예제를 사용합니다. 오류 문구와 밑줄 표시는 버전·편집기에 따라 달라질 수 있어요. 파일 경로는 읽기 쉽게 파일 이름으로 줄였고, 코드는 복사할 수 있도록 본문에 그대로 넣었습니다.

두 줄로 오류를 만들고 마지막 줄을 읽으세요

새 파일 type-error.py를 만들고 아래 코드를 저장하세요. 평소 쓰는 Python 3 실행 기능으로 이 파일을 실행합니다. 명령줄을 쓰고 python3 --version이 Python 3으로 확인되는 환경이라면 파일이 있는 폴더에서 python3 type-error.py를 입력해도 됩니다. 코드 앞에 줄 번호나 >>>는 붙이지 마세요.

count = "3"
print(count + 2)

이번 실행에서는 숫자 5 대신 다음 오류가 나왔습니다. 아래는 화면을 재현한 그림이 아니라 실제 실행 출력의 텍스트입니다.

Traceback (most recent call last):
  File "type-error.py", line 2, in <module>
    print(count + 2)
          ~~~~~~^~~
TypeError: can only concatenate str (not "int") to str

먼저 TypeError를 봅니다. 이 예제에서는 str인 문자와 int인 정수를 그대로 더하려 했다는 뜻이에요. 오류 이름은 문제의 종류, 콜론 뒤 문장은 이번 실패의 단서입니다. Python 공식 오류 안내에서도 마지막 줄의 종류·설명과 그 위의 실행 경로를 구분합니다.

줄 번호는 출발점이고 값의 정의도 확인해야 해요

File 뒤는 실행한 파일, line 2는 오류가 보고된 두 번째 줄입니다. 그 아래 print(count + 2)가 해당 코드예요. 밑줄이 가리키는 덧셈을 보고, count를 만든 첫 줄로 올라가 보세요. "3"은 따옴표 때문에 숫자 3이 아닌 문자열입니다.

즉, 두 번째 줄만 삭제하면 문제가 해결되는 것이 아닙니다. 덧셈하려는 값의 자료형을 먼저 맞춰야 합니다. 아래 설명도는 오류가 보고된 줄과 값을 정의한 줄의 관계를 보여줍니다. 실제 터미널 화면을 캡처한 이미지는 아닙니다.

1행 count의 따옴표 문자열이 2행 정수 덧셈에 들어가 TypeError가 발생하는 관계
오류 위치는 2행이지만 확인할 값은 1행에서 만들어졌습니다. 작은 문구는 이미지를 눌러 원본으로 볼 수 있습니다.

함수를 여러 번 거치는 코드라면 File 줄도 여러 개 나올 수 있습니다. 아래쪽부터 보면서 내가 작성한 파일을 찾고 호출한 줄을 함께 확인하세요. 외부 라이브러리 파일이 보인다고 그 파일부터 고치지는 마세요. 오류 묶음이 둘 이상이면 앞선 오류가 다음 오류의 원인일 수 있으므로 마지막 한 줄만 남기지 말고 전체를 보관합니다.

정수로 바꾼 뒤 5가 나오는지 확인하세요

이 예제의 목적은 숫자 덧셈입니다. 두 번째 줄의 count를 int(count)로 바꾸고 저장한 뒤 같은 파일을 다시 실행하세요.

count = "3"
print(int(count) + 2)

실제 출력은 5였고 오류 없이 종료됐습니다. 공식 int 설명처럼 정수로 해석할 수 있는 문자열을 변환한 것입니다. 원래부터 숫자를 직접 적으려던 코드라면 첫 줄을 count = 3으로 작성하는 방법도 있습니다.

모든 TypeError에 int를 붙이는 것은 아닙니다. 글자를 이어 붙이려는 작업인지, 숫자를 계산하려는 작업인지부터 정해야 해요. 이번 목표는 3과 2를 더해 5를 얻는 것이므로 정수 변환을 골랐습니다.

이번에는 첫 줄을 count = "three"로 바꾸고 같은 변환 코드를 실행해 보세요. 실제 실행에서는 ValueError: invalid literal for int() with base 10: 'three'가 나왔습니다. 영어 단어를 int가 숫자 3으로 번역해 주지는 않습니다. 입력을 정수 형태로 고치고 다시 실행해야 합니다. 오류 종류가 바뀌었다면 새 마지막 줄을 기준으로 다음 원인을 확인하세요.

이름 오류와 문법 오류는 다른 곳을 고칩니다

공식 내장 예외 목록은 NameError, TypeError, ValueError를 구분합니다. 이름을 외우기보다 지금 코드에서 무엇을 확인할지 연결해 보세요.

  • NameError: count = 3 다음 줄에 print(cout + 2)를 실행하자 name 'cout' is not defined가 나왔습니다. 이 경우에는 cout의 철자가 원인입니다. 정의한 이름 count와 대소문자·철자를 맞추세요. 다른 코드에서는 이름을 정의하기 전에 사용했는지도 확인합니다.
  • SyntaxError: if True print("ok")를 실행하자 print 부근이 표시됐습니다. 하지만 이 예제에서 빠진 것은 그 앞의 콜론입니다. 표시 위치는 문법 문제를 발견한 곳이며, 반드시 그 글자 자체가 수정 대상인 것은 아닙니다.

문법 예제는 다음처럼 콜론과 들여쓰기를 넣어 실행했습니다. 실제 출력 ok를 확인했습니다.

if True:
    print("ok")

고친 파일을 다시 실행하고 결과로 끝내세요

실습 파일을 count = "3"과 print(int(count) + 2) 두 줄로 되돌려 저장하세요. 다시 실행해 오류 없이 5가 출력되면 이번 실습은 끝입니다. 오류가 사라져도 32처럼 다른 결과가 나오면 목적대로 계산한 것은 아니니 입력값과 연산을 다시 확인하세요. 다음에는 리스트 합계를 구하는 실습에서 여러 값의 자료형을 확인해 볼 수 있습니다.

계속 같은 오류라면 메시지의 파일 이름이 방금 저장한 파일인지 먼저 확인하세요. 그래도 풀리지 않으면 실행한 코드, 전체 오류 출력, Python 버전, 기대한 결과를 함께 정리해 질문하면 됩니다. 코드 한 곳을 바꿀 때마다 저장과 재실행을 묶으면 어떤 수정이 결과를 바꿨는지 확인할 수 있어요.

댓글 남기기