파이썬 UnboundLocalError: 지역 변수 참조 오류 해결 가이드

카테고리 없음

vibespace 2025. 4. 19. 23:39

UnboundLocalError란 무엇인가?

파이썬에서 UnboundLocalError는 지역 변수를 참조하려고 할 때, 그 변수가 아직 할당되지 않은 경우에 발생하는 오류입니다. 즉, 지역 변수가 함수 내에서 참조되기 전에 값이 할당되지 않았을 때 발생하는 오류입니다.

다음은 UnboundLocalError를 발생시키는 간단한 예제입니다. 함수 내에서 지역 변수를 참조하려고 했지만, 해당 변수에 값이 할당되지 않았습니다.


def test_function():
    print(x)  # UnboundLocalError 발생
    x = 10

test_function()

이 코드는 x를 함수 내에서 참조하려고 하지만, 실제로 x는 나중에 할당됩니다. 이로 인해 UnboundLocalError가 발생합니다.

UnboundLocalError는 다음과 같은 경우에 발생할 수 있습니다:

지역 변수와 전역 변수가 이름이 동일할 때: 함수 내에서 전역 변수를 변경하려고 시도할 경우, 파이썬은 해당 변수를 지역 변수로 간주하여 오류를 발생시킵니다.
지역 변수에 값 할당 전에 참조할 때: 변수에 값이 할당되기 전에 참조하려고 하면 UnboundLocalError가 발생합니다.

가장 간단한 해결책은 지역 변수를 참조하기 전에 먼저 값을 할당하는 것입니다. 예를 들어, 아래와 같이 코드를 수정할 수 있습니다:


def test_function():
    x = 10
    print(x)  # 정상 동작

test_function()

이 코드는 정상적으로 동작하며, 지역 변수 x는 값이 할당된 후에 참조됩니다.

지역 변수와 전역 변수의 이름이 충돌할 때도 UnboundLocalError가 발생할 수 있습니다. 예를 들어, 함수 내에서 전역 변수를 수정하려고 할 때가 그렇습니다.


x = 5  # 전역 변수

def test_function():
    x = 10  # 지역 변수로 재정의
    print(x)  # 10 출력

test_function()
print(x)  # 5 출력 (전역 변수는 변하지 않음)

위 코드는 x가 지역 변수로 재정의되어 함수 내에서 10을 출력하지만, 전역 변수 x는 영향을 받지 않습니다.

지역 변수와 전역 변수의 이름 충돌을 피하려면, 함수 내에서 전역 변수의 값을 수정할 때 global 키워드를 사용하는 것이 좋습니다:


x = 5  # 전역 변수

def test_function():
    global x  # 전역 변수 x를 참조
    x = 10
    print(x)  # 10 출력

test_function()
print(x)  # 10 출력 (전역 변수 x가 수정됨)

이 코드에서는 global 키워드를 사용하여 함수 내에서 전역 변수 x를 수정할 수 있습니다. 이 방식은 전역 변수를 변경해야 할 경우에 유용합니다.

전역 변수 값을 함수 내에서 참조하려면, 그 변수에 값이 할당되기 전에 참조하는 일이 없도록 해야 합니다. 만약 함수 내에서 전역 변수를 사용하려면, 전역 변수를 함수에 전달하거나 global 키워드를 사용해야 합니다.


x = 5  # 전역 변수

def test_function():
    global x  # 전역 변수 사용
    print(x)  # 5 출력

test_function()

주의: 함수 내에서 전역 변수를 수정하려면 global을 사용하고, 단순히 참조만 하려면 그냥 사용할 수 있습니다.

UnboundLocalError를 디버깅할 때 유용한 몇 가지 팁은 다음과 같습니다:

변수 할당 순서 확인: 변수에 값을 할당하기 전에 참조되지 않도록 항상 할당 순서를 체크하세요.
전역 변수와 지역 변수 구분: 함수 내에서 변수 이름이 전역 변수와 충돌하지 않도록 주의하고, 전역 변수를 수정할 필요가 있다면 global을 사용하세요.
함수 내 변수 스코프 파악: 함수 내에서 변수가 참조될 때 그 변수가 지역 변수인지 전역 변수인지 명확히 파악하세요.
디버깅 도구 사용: 파이썬 디버거인 pdb를 사용하여 변수의 값을 확인하고, 오류 발생 위치를 추적해 보세요.

UnboundLocalError는 대부분 지역 변수를 참조하기 전에 값을 할당하지 않거나, 지역 변수와 전역 변수의 이름이 충돌할 때 발생합니다. 이 오류를 예방하려면:

이 간단한 점들만 기억하면, UnboundLocalError를 방지하고 효율적인 파이썬 코딩을 할 수 있습니다.