IndentationError: expected an indented block 에러 해결법 – 원인 분석부터 완벽 해결까지

🚨 도입부

Python을 처음 접하거나 경험이 많은 개발자라 하더라도, ‘IndentationError: expected an indented block’라는 에러 메시지는 종종 우리를 당황하게 만듭니다. 프로젝트 마감일이 가까워지고 있는데, 코드가 예상치 못한 이유로 작동하지 않을 때의 좌절감은 이루 말할 수 없습니다. 이 에러는 특히 코드의 구조를 중요시하는 Python에서 더 빈번하게 발생하며, 심지어 아주 간단한 실수로 인해 발생할 수 있습니다. 예를 들어, 조건문이나 함수 정의 후 들여쓰기를 깜빡한 경우, 복잡한 코드 블록을 복사하고 붙여넣기 할 때 들여쓰기 오류가 발생하는 경우, 또는 다른 개발자와 협업 중 서로 다른 코드 스타일로 인해 발생할 수 있습니다.

이 글에서는 ‘IndentationError: expected an indented block’ 에러의 정확한 원인을 분석하고, 이를 해결할 수 있는 구체적인 방법들을 제시합니다. 이 과정에서 여러분은 이 에러의 원인을 명확히 이해하게 될 것이며, 이를 통해 코드 작성 시 동일한 실수를 반복하지 않도록 도와드리겠습니다. 예상 해결 시간은 상황에 따라 다르지만, 대부분의 경우 몇 분 내에 해결할 수 있습니다. 난이도는 비교적 쉬운 편이나, 코드 구조를 이해하는 데 약간의 시간이 필요할 수 있습니다.

🔍 에러 메시지 상세 분석

에러 메시지 ‘IndentationError: expected an indented block’는 Python에서 아주 자주 발생하는 에러 중 하나입니다. 이 에러는 주로 코드 블록의 시작 지점에서 올바른 들여쓰기가 되지 않았을 때 발생합니다. Python은 들여쓰기를 통해 코드 블록을 구분하기 때문에, 들여쓰기가 잘못되면 해석할 수 없는 코드로 인식됩니다.

에러가 발생할 수 있는 상황은 다양합니다. 첫 번째로, 함수 정의 후 들여쓰기가 없을 때입니다. 예를 들어:

def my_function():
print("Hello, world!")

위의 코드는 ‘IndentationError: expected an indented block’ 에러를 발생시킵니다. 함수 정의 다음 줄에는 적어도 하나의 들여쓰기가 있어야 합니다.

두 번째로, 조건문 내부 블록이 들여쓰기로 구분되지 않을 때입니다. 예를 들어:

if True:
print("This is true")

위 코드에서 ‘print’ 문은 들여쓰기 되어야 합니다.

세 번째로, 루프 구조 내에서 들여쓰기가 잘못된 경우입니다. 예를 들어:

for i in range(5):
print(i)

이 경우에도 마찬가지로 ‘print’ 문은 들여쓰기 되어야 합니다.

네 번째로, 클래스 메서드 정의 시 들여쓰기가 되지 않은 경우가 있습니다:

class MyClass:
def my_method(self):
print("Hello from method")

다섯 번째, 복잡한 중첩 블록에서 실수로 들여쓰기가 잘못되는 경우가 있습니다. 이런 경우는 특히 코드 복사/붙여넣기 시에 자주 발생합니다.

이 에러 메시지를 읽을 때, ‘expected an indented block’라는 부분에 주목해야 합니다. 이는 Python 인터프리터가 들여쓰기를 기대했으나 발견하지 못했다는 의미입니다. 비슷한 에러로는 ‘IndentationError: unindent does not match any outer indentation level’이 있는데, 이는 동일한 수준의 들여쓰기가 일치하지 않을 때 발생하는 에러입니다.

🧐 발생 원인 분석

‘IndentationError: expected an indented block’의 주요 원인들을 살펴보겠습니다. 이 에러는 주로 들여쓰기의 부재 또는 잘못된 들여쓰기로 인해 발생합니다.

첫 번째 원인은 함수 정의 이후 들여쓰기가 없는 경우입니다. 예시를 보겠습니다:

def calculate_sum(a, b):
sum = a + b
return sum

위 예시에서 ‘sum = a + b’와 ‘return sum’은 들여쓰기 되어 있어야 합니다. 들여쓰기를 적용한 올바른 코드는 다음과 같습니다:

def calculate_sum(a, b):
    sum = a + b
    return sum

두 번째 원인은 조건문에서 들여쓰기가 없는 경우입니다. 예를 들어, 다음과 같은 코드에서 발생할 수 있습니다:

if x > 0:
print("x is positive")

정상적인 들여쓰기가 적용된 코드는 다음과 같습니다:

if x > 0:
    print("x is positive")

세 번째 원인은 루프 내에서 들여쓰기가 없는 경우입니다. 예를 들어:

for number in range(5):
print(number)

이 경우의 해결된 코드는 다음과 같습니다:

for number in range(5):
    print(number)

네 번째는 클래스 내 메서드 정의 시 들여쓰기가 없는 경우입니다:

class Dog:
def bark(self):
print("Woof!")

올바른 코드는 다음과 같습니다:

class Dog:
    def bark(self):
        print("Woof!")

다섯 번째, 복잡한 블록 구조에서 실수로 들여쓰기가 잘못되어 발생하는 경우입니다. 이는 코드 복사/붙여넣기 시 발생할 수 있습니다. 예를 들어:

def outer_function():
    def inner_function():
    print("Inner function")
inner_function()

위 코드는 ‘inner_function’을 호출하는 부분이 잘못된 위치에 있습니다. 올바른 코드는 다음과 같습니다:

def outer_function():
    def inner_function():
        print("Inner function")
    inner_function()

이러한 문제들은 주로 Python의 들여쓰기 규칙을 잘못 이해하거나, 코드 편집기에서 자동으로 들여쓰기를 변경하지 않았을 때 발생합니다. 특히, 탭과 공백을 혼용할 때 문제가 발생할 수 있습니다. 다른 운영체제나 개발 도구에서 코드 스타일이 다를 수 있으므로 주의가 필요합니다. 각 원인별로 간단히 확인할 수 있는 방법은 코드 블록을 명확히 구분하여 들여쓰기를 확인하는 것입니다.

✅ 해결 방법

이제 ‘IndentationError: expected an indented block’ 에러를 해결하는 방법을 알아보겠습니다.

즉시 해결: 1분 내 적용 가능한 빠른 방법

• 코드 블록이 시작되는 지점에서 들여쓰기를 확인하고 추가합니다.
• 편집기의 자동 들여쓰기 기능을 사용하여 블록을 정렬합니다.
• 탭과 공백이 혼용되지 않도록 통일합니다.

예를 들어, 다음과 같은 코드를 보겠습니다:

if y > 10:
print("Large number")

이 경우, ‘print’ 문 앞에 들여쓰기를 추가합니다:

if y > 10:
    print("Large number")

표준 해결: 일반적이고 안전한 해결법

• 모든 코드 블록을 들여쓰기 합니다. Python에서는 일반적으로 4개의 공백을 사용합니다.
• 코드가 복잡할수록 주석을 추가하여 블록의 시작과 끝을 명확히 합니다.
• 들여쓰기 규칙을 팀원들과 공유하여 스타일을 통일합니다.
• 코드 에디터의 설정을 확인하여 들여쓰기가 자동으로 처리되도록 합니다.
• 코드 작성 후 실행하기 전에 린터를 사용하여 스타일 오류를 점검합니다.

다음은 들여쓰기가 적용된 클래스 메서드 예제입니다:

class Animal:
    def speak(self):
        print("Animal speaking")

고급 해결: 복잡한 상황을 위한 해결법

• 복잡한 코드에서 블록을 함수로 분리하여 관리합니다.
• 자동 포매팅 도구를 사용하여 코드 스타일을 일관되게 유지합니다.
• 다른 개발자와 협업 시 코드 리뷰를 통해 들여쓰기 오류를 검출합니다.

예를 들어, 복잡한 함수에서 부분을 분리하는 방법은 다음과 같습니다:

def main_function():
    def helper_function():
        print("Helper function")
    helper_function()

이렇게 코드를 분리하면 코드의 가독성과 유지보수성이 향상됩니다. 각 해결법을 적용한 후, 코드를 실행하여 에러 메시지가 사라졌는지 확인합니다.

🛡️ 예방법 및 베스트 프랙티스

이 에러를 예방하기 위해서는 몇 가지 주의사항과 베스트 프랙티스를 따르는 것이 중요합니다.

• 코드를 작성할 때는 항상 일관된 들여쓰기 스타일을 유지하십시오. 보통 4개의 공백을 사용하는 것이 표준입니다.
• 코드 편집기의 자동 들여쓰기 기능을 사용하여 일관성을 유지합니다.
• 팀 개발 시, 들여쓰기 스타일을 명시하고, 이를 문서화하여 팀원들과 공유합니다.
• 코드 작성 후 실행하기 전에 린터를 사용하여 들여쓰기 오류를 잡아냅니다.
• 복잡한 코드 블록은 함수로 분리하여 관리합니다. 이는 가독성과 유지보수성을 높이는 데 도움이 됩니다.

또한, 코드 리뷰를 통해 팀원 간의 코드 스타일을 점검하고, 서로 피드백을 주고받는 것이 좋습니다. 이러한 과정은 코드 품질을 높이는 데 큰 도움이 됩니다.

🎯 마무리 및 추가 팁

이 글에서는 ‘IndentationError: expected an indented block’ 에러의 원인과 해결법에 대해 자세히 알아보았습니다. 핵심 내용은 다음과 같습니다:

• Python의 들여쓰기 규칙을 이해하고 준수합니다.
• 자동 포매팅 도구와 린터를 활용하여 코드 스타일을 점검합니다.
• 팀원들과 스타일 가이드를 공유하여 일관성을 유지합니다.

비슷한 에러로 ‘IndentationError: unindent does not match any outer indentation level’이 있으며, 이와 관련된 글도 참고하시기 바랍니다. 추가 학습 리소스로는 Python 공식 문서와 다양한 온라인 코딩 플랫폼을 추천합니다. 여러분이 이 에러를 극복하고 더 나은 코드를 작성할 수 있도록 언제나 응원합니다!