Python에서 "NameError: name is not defined" 오류 해결하기

Python에서 발생하는 "NameError: name is not defined" 오류는 코드에서 사용하려는 변수나 함수, 클래스 등이 정의되지 않았을 때 발생합니다. 이 오류는 변수나 함수의 이름을 잘못 입력했거나, 변수 선언 전에 사용하려 할 때 자주 발생합니다. 이번 글에서는 이 오류의 원인과 해결 방법을 살펴보겠습니다.

1. 'NameError: name is not defined' 오류 원인

이 오류는 주로 아래와 같은 이유로 발생합니다:

변수나 함수의 이름을 잘못 입력한 경우: 변수나 함수 이름을 잘못 입력하거나, 대소문자를 구분하지 않으면 Python에서 정의되지 않은 이름으로 인식하고 오류가 발생합니다.
변수나 함수가 정의되기 전에 사용한 경우: 변수를 사용하기 전에 정의하지 않으면 Python은 해당 변수를 찾을 수 없으므로 오류가 발생합니다.
스코프(scope) 문제: 함수 내에서 정의된 변수는 그 함수 밖에서는 접근할 수 없습니다. 따라서, 함수 밖에서 함수 내 변수에 접근하려고 할 때도 오류가 발생할 수 있습니다.

2. 'NameError: name is not defined' 오류 해결 방법

이 오류를 해결하기 위한 방법은 아래와 같습니다.

2.1 변수나 함수 이름 확인하기

가장 일반적인 원인은 변수나 함수의 이름을 잘못 입력하는 경우입니다. 변수나 함수 이름을 정확히 입력했는지, 대소문자가 일치하는지 확인해야 합니다. Python은 대소문자를 구분하므로, 같은 이름이라도 대소문자에 따라 다른 것으로 인식합니다.


# 잘못된 코드: 변수명 대소문자 구분 오류
myVariable = 10
print(myvariable)  # "NameError: name 'myvariable' is not defined" 오류 발생

# 올바른 코드: 대소문자 구분을 정확히 맞춤
myVariable = 10
print(myVariable)  # 정상 실행

위 코드에서는 `myVariable`과 `myvariable`을 혼동하여 오류가 발생합니다. Python에서는 `myVariable`과 `myvariable`을 서로 다른 변수로 인식하므로 정확한 이름을 사용해야 합니다.

2.2 변수 정의 전에 사용하지 않기

변수를 사용하기 전에 정의해야 합니다. 변수를 선언하기 전에 사용하려 하면 Python은 해당 변수를 찾을 수 없기 때문에 "NameError"가 발생합니다.


# 잘못된 코드: 변수 정의 전에 사용
print(x)  # "NameError: name 'x' is not defined"
x = 10

# 올바른 코드: 변수를 사용하기 전에 정의
x = 10
print(x)  # 정상 실행

위 예시에서 `x` 변수를 선언하기 전에 `print(x)`를 호출하면 오류가 발생합니다. 따라서 변수는 사용하기 전에 정의해야 합니다.

2.3 함수 내 변수의 스코프 확인하기

Python에서는 함수 내에서 정의된 변수는 그 함수 밖에서 접근할 수 없습니다. 즉, 함수 외부에서 내부 변수에 접근하려고 하면 "NameError"가 발생합니다. 이를 해결하려면 변수의 스코프(scope)를 고려해야 합니다.


# 잘못된 코드: 함수 내 변수에 함수 밖에서 접근
def my_function():
    y = 20
print(y)  # "NameError: name 'y' is not defined"

# 올바른 코드: 함수 내에서 변수 사용
def my_function():
    y = 20
    print(y)  # 함수 내에서 정상 실행

my_function()

위 코드에서 `y`는 `my_function` 함수 내부에서만 정의되므로, 함수 외부에서는 접근할 수 없습니다. 이를 해결하려면 함수 외부에서 사용할 변수는 함수 밖에서 정의해야 합니다.

2.4 글로벌 변수와 로컬 변수 구분하기

글로벌 변수는 함수 외부에서 정의되고, 로컬 변수는 함수 내에서 정의됩니다. 함수 내에서 글로벌 변수를 사용하려면 `global` 키워드를 사용해야 합니다. 아래 예시를 참고하세요:


# 잘못된 코드: 글로벌 변수 사용 시 오류 발생
x = 10
def my_function():
    print(x)  # "NameError: name 'x' is not defined"

my_function()

# 올바른 코드: 글로벌 변수 사용 시 global 키워드 사용
x = 10
def my_function():
    global x
    print(x)  # 정상 실행

my_function()

위 코드에서 `x`는 글로벌 변수이지만 함수 내에서 `global` 키워드를 사용하여 `x`를 참조하고 있습니다. `global`을 사용하지 않으면 Python은 함수 내에서 새로운 로컬 변수를 만들려고 시도하므로 오류가 발생합니다.

2.5 모듈에서 변수나 함수 불러오기

다른 파일에서 변수를 불러오거나 사용할 때는 해당 변수를 정확히 임포트해야 합니다. 모듈에서 변수나 함수를 사용하려면 `import` 문을 제대로 작성해야 하며, `from module_name import` 구문을 사용하여 특정 변수를 불러올 수도 있습니다.


# 잘못된 코드: 모듈을 임포트하지 않음
# file1.py
a = 10

# file2.py
print(a)  # "NameError: name 'a' is not defined"

# 올바른 코드: 모듈을 임포트하여 사용
# file1.py
a = 10

# file2.py
from file1 import a
print(a)  # 정상 실행

위 코드에서 `file1.py`에 정의된 변수 `a`를 `file2.py`에서 사용하려면 `from file1 import a`와 같은 구문을 사용하여 변수를 임포트해야 합니다. 그렇지 않으면 `NameError`가 발생합니다.

3. 결론

"NameError: name is not defined" 오류는 코드에서 변수를 잘못 사용하거나, 변수나 함수가 정의되지 않았을 때 발생하는 오류입니다. 이 오류를 해결하려면 변수나 함수의 이름을 정확히 입력하고, 변수를 정의하기 전에 사용하지 않도록 하며, 함수 내외부에서 변수의 스코프를 잘 관리해야 합니다. 또한, 글로벌 변수나 다른 파일에서 변수를 사용할 때는 적절한 방법으로 임포트하거나 `global` 키워드를 사용해야 합니다.

smartmove 님의 블로그

Python에서 "NameError: name is not defined" 오류 해결하기