파이썬에서 자주 발생하는 에러와 해결 방법

코딩을 하다 보면 에러가 나올때 마다 이거 어떻게 해결하지 하고 고민을 많이 하시죠? 초보자부터 경험이 많은 개발자까지 누구나 실수할 수 있지만, 자주 발생하는 오류를 미리 알고 있다면 문제를 빠르게 해결할 수 있습니다. 이번 글에서는 파이썬에서 가장 흔하게 발생하는 에러 10가지와 그 해결 방법을 알아보겠습니다.

1. SyntaxError (문법 오류)

오류 예시:

if True
    print("Hello")

원인: 문법이 잘못되었거나 : 같은 기호가 빠진 경우
해결 방법:

if True:
    print("Hello")

2. NameError (변수/함수 이름 오류)

오류 예시:

print(value)

원인: value 변수가 정의되지 않음
해결 방법: 변수를 먼저 정의한 후 사용

value = 10
print(value)

3. TypeError (타입 오류)

오류 예시:

print("Age: " + 25)

원인: 문자열과 숫자를 직접 연결하려고 시도
해결 방법: 문자열로 변환 후 연결

print("Age: " + str(25))

4. IndexError (인덱스 범위 초과 오류)

오류 예시:

my_list = [1, 2, 3]
print(my_list[5])

원인: 리스트 범위를 초과한 인덱스를 사용
해결 방법: 리스트 크기를 확인한 후 접근

if len(my_list) > 5:
    print(my_list[5])

5. KeyError (딕셔너리 키 오류)

오류 예시:

my_dict = {"name": "Alice"}
print(my_dict["age"])

원인: 존재하지 않는 키를 사용
해결 방법: .get() 메서드를 사용하여 기본값 반환

print(my_dict.get("age", "Not found"))

6. AttributeError (속성 오류)

오류 예시:

num = 10
num.append(5)

원인: int 객체에는 append() 메서드가 없음
해결 방법: 올바른 타입인지 확인하고 사용

7. ValueError (값 오류)

오류 예시:

int("hello")

원인: 변환할 수 없는 값을 숫자로 변환 시도
해결 방법: 입력값을 확인 후 변환

8. ZeroDivisionError (0으로 나누기 오류)

오류 예시:

print(10 / 0)

원인: 0으로 나누기 시도
해결 방법: 나누는 값이 0인지 체크

denominator = 0
if denominator != 0:
    print(10 / denominator)
else:
    print("Cannot divide by zero")

9. ModuleNotFoundError (모듈 찾기 오류)

오류 예시:

import non_existing_module

원인: 존재하지 않는 모듈을 불러옴
해결 방법: 모듈이 설치되어 있는지 확인

pip install module_name

10. ImportError (모듈 내부 함수/클래스 오류)

오류 예시:

from math import square

원인: math 모듈에는 square 함수가 없음
해결 방법: 올바른 함수인지 확인 후 사용
이런 에러들은 파이썬에서 자주 발생하는 문제들이지만, 원인을 이해하고 해결하는 방법을 익히면 디버깅이 훨씬 쉬워집니다. 또한 try-except 문을 활용하면 오류를 보다 우아하게 처리할 수도 있습니다.
코딩할 때 에러를 두려워하지 말고 하나씩 해결해 나가면 실력이 더욱 향상될 것입니다.