[Python] NameError: name 'XYZ' is not defined 오류 해결 방법

 

파이썬을 사용하다 보면 가끔 NameError: name 'XYZ' is not defined라는 오류 메시지를 마주칠 때가 있습니다. 이 글에서는 이 오류가 왜 발생하는지와 해결 방법을 자세히 알아보겠습니다.

오류 발생 원인

NameError는 파이썬에서 가장 흔히 보는 오류 중 하나로, 선언되지 않은 변수를 참조하려고 할 때 발생합니다. 즉, 사용하려는 변수나 함수명이 프로그램 상에서 정의되지 않았을 때 이 오류가 나타납니다.

문제 상황 예시

다음은 간단한 코드 예시입니다

def function():
    print(XYZ)  # XYZ가 정의되지 않았음

function()

 

이 코드를 실행하면 XYZ가 정의되지 않았기 때문에 NameError: name 'XYZ' is not defined 오류가 발생합니다.

해결 방법

1. 변수 확인: 변수가 선언되었는지, 오타는 없는지 확인합니다.
2. 스코프 확인: 변수가 올바른 스코프 내에 선언되어 있는지 확인합니다. 함수 내부에서만 유효한 지역 변수를 외부에서 참조하려고 하면 이 오류가 발생할 수 있습니다.
3. 라이브러리 확인: 사용하려는 객체가 외부 라이브러리의 일부인 경우, 해당 라이브러리가 정상적으로 임포트되었는지 확인합니다.

수정된 코드

위의 예시를 수정하여 오류를 해결해 봅시다:

XYZ = "Hello, World!"  # XYZ를 정의

def function():
    print(XYZ)

function()

 

이제 XYZ가 전역 변수로 정의되어 있으므로 함수 내부에서도 문제없이 접근할 수 있고, 오류가 발생하지 않습니다.

결론

NameError는 변수를 사용하기 전에 적절히 정의해야 한다는 기본적인 프로그래밍 원칙을 상기시켜 줍니다. 코드를 작성할 때 변수 이름을 정확히 사용했는지, 모든 필요한 라이브러리가 임포트되었는지 확인하는 습관을 기르면 이러한 오류를 효과적으로 예방할 수 있습니다.

 

이 글이 파이썬 프로그래밍 시 발생할 수 있는 NameError 오류를 이해하고 해결하는 데 도움이 되길 바랍니다. 다른 프로그래밍 관련 궁금증이 있다면 언제든지 문의해 주세요.