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

🚨 도입부

“IndentationError: expected an indented block” 에러는 Python 개발자라면 한 번쯤은 겪어봤을 만한 오류입니다. 이 에러는 특히 파이썬 문법이 익숙하지 않은 초보 개발자들에게 큰 좌절감을 안겨주곤 합니다. 이 에러는 쉽게 해결될 수 있지만, 처음 마주쳤을 때는 어디서 시작해야 할지 막막할 수 있습니다. 예를 들어, 코드를 작성하다가 함수 내부에 코드를 넣지 않았을 때, 반복문이나 조건문 다음에 코드를 들여쓰지 않았을 때, 또는 복사-붙여넣기 과정에서 들여쓰기가 잘못되어 발생할 수 있습니다.

이 글을 통해 여러분은 이 에러의 발생 원인과 구체적인 해결책을 얻을 수 있습니다. 여러분이 이 글을 읽고 나면, 이 에러를 스스로 진단하고 해결할 수 있는 능력을 갖추게 될 것입니다. 이 에러를 해결하는 데 보통 몇 분에서 길게는 10분 정도가 걸릴 수 있으며, 난이도는 초급에 속합니다.

🔍 에러 메시지 상세 분석

“IndentationError: expected an indented block”이라는 에러 메시지는 파이썬 인터프리터가 특정 구문에서 예상되는 들여쓰기를 찾지 못했을 때 발생합니다. 다양한 상황에서 발생할 수 있습니다. 예를 들어:

• 함수 정의 후에 아무 코드도 들여쓰지 않았을 때
• for, while, if, elif, else 등 블록을 열었지만 들여쓰기 된 코드가 없을 때
• 복사-붙여넣기 과정에서 들여쓰기가 잘못되었을 때
• 탭과 스페이스 혼용으로 인한 들여쓰기 오류
• 코드 블록을 지나치게 들여쓰거나 들여쓰기를 하지 않았을 때

이 에러 메시지는 특히 초보자들에게 혼란스러울 수 있습니다. ‘expected an indented block’은 Python이 특정 구문에서 블록을 열었지만, 그에 따른 코드를 찾지 못했다는 의미입니다. 이와 유사한 에러로는 “IndentationError: unexpected indent”가 있으며, 이는 예상치 못한 위치에 들여쓰기가 있을 때 발생합니다.

🧐 발생 원인 분석

이 에러의 주요 원인은 다음과 같습니다:

1. 함수나 조건문, 반복문 다음에 코드가 없을 때: Python은 들여쓰기를 통해 코드 블록을 구분하므로, 블록을 시작하는 구문 뒤에는 들여쓰기된 코드가 필요합니다.
2. 들여쓰기 수준이 잘못되었을 때: 코드 블록의 시작과 끝을 명확히 하지 않으면, Python은 적절한 들여쓰기를 요구합니다.
3. 탭과 스페이스의 혼용: Python은 탭과 스페이스를 혼용하는 것을 허용하지 않으며, 이는 들여쓰기 오류로 이어질 수 있습니다.
4. 코드 복사-붙여넣기 과정에서의 실수: 다른 에디터에서 복사한 코드가 Python의 들여쓰기 규칙을 따르지 않을 수 있습니다.
5. 코드 주석 처리 과정에서의 실수: 주석을 추가하거나 제거하는 과정에서 들여쓰기가 잘못될 수 있습니다.

이러한 원인은 주로 개발자가 코드 작성 시 주의하지 않거나, 자동화된 도구의 설정이 잘못되었을 때 발생합니다. 각 원인은 운영 체제나 사용하는 개발 도구에 따라 다르게 나타날 수 있습니다. 예를 들어, Windows와 Unix 계열 시스템에서의 탭과 스페이스 처리 방식이 다를 수 있습니다. 각 원인을 확인하는 간단한 방법으로는, 코드 작성 후 자동 들여쓰기 기능을 사용하거나, 코드 블록을 명확히 구분하는 방법이 있습니다.

✅ 해결 방법

즉시 해결

1. 자동 들여쓰기 기능 사용: 대부분의 코드 편집기는 자동 들여쓰기 기능을 제공하여, 코드를 작성할 때 자동으로 올바른 들여쓰기를 적용할 수 있습니다.

2. 코드 블록 확인: 코드의 시작과 끝을 명확히 하고, 블록 내의 코드가 올바르게 들여쓰기 되어 있는지 확인합니다.

# 잘못된 예시
if True:
print("Hello World")

# 수정된 예시
if True:
    print("Hello World")  # if 블록 내에 있어야 하므로 들여쓰기 필수

3. 탭과 스페이스 일관성 유지: 탭이나 스페이스 중 하나를 선택하여 일관되게 사용합니다. 일반적으로 스페이스 4개를 사용하는 것이 권장됩니다.

표준 해결

1. Python 린터 사용: Pylint, Flake8 같은 린터를 사용하여 코드 스타일 및 오류를 자동으로 점검합니다.

2. IDE의 코드 포맷 기능 활용: Visual Studio Code, PyCharm 등의 IDE는 코드 포맷 기능을 제공하여, 전체 코드를 자동으로 들여쓰기할 수 있습니다.

# 잘못된 예시
for i in range(3):
print(i)

# 수정된 예시
for i in range(3):
    print(i)  # for 블록 내에 있어야 하므로 들여쓰기 필수

3. 코드 리뷰 과정에서의 점검: 팀 개발 중 코드 리뷰를 통해 들여쓰기 오류를 사전에 방지합니다.

4. 주석과 코드 분리: 주석 추가 시 코드와 주석의 들여쓰기를 명확히 구분하여 오류를 방지합니다.

# 잘못된 예시
if condition:
# 주석
    execute()

# 수정된 예시
if condition:
    # 주석
    execute()

5. 문서화 및 가이드라인 작성: 팀 내 Python 코딩 가이드라인을 작성하여 들여쓰기 규칙을 명시합니다.

고급 해결

1. Pre-commit 훅 설정: Git의 pre-commit 훅을 사용하여 커밋 전에 자동으로 린터를 실행하여 들여쓰기 오류를 점검합니다.

# .pre-commit-config.yaml 예시
repos:
-   repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v3.1.0
    hooks:
    - id: trailing-whitespace
    - id: end-of-file-fixer

2. CI/CD 파이프라인에 코드 스타일 검사 추가: 지속적 통합 파이프라인에서 코드 스타일 검사를 추가하여, 코드 병합 전에 오류를 잡아냅니다.

3. 복잡한 프로젝트에 코드 스타일 자동화 도구 적용: Black 같은 코드 포매터를 프로젝트에 적용하여 일관된 코드 스타일을 유지합니다.

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

1. 일관된 들여쓰기 스타일 유지: 프로젝트에 맞는 들여쓰기 스타일을 정의하고, 이를 준수합니다.

2. 코드 린터 및 포매터 사용: Pylint, Black 등 린터와 포매터를 사용하여 코드 일관성을 유지합니다.

3. 자동화된 도구 활용: IDE의 자동 들여쓰기 기능을 사용하여 실수를 방지합니다.

4. 팀 내 코드 스타일 가이드라인 공유: 팀 내에서 일관된 코딩 스타일을 유지하기 위해, 가이드라인을 문서화하고 공유합니다.

5. 정기적인 코드 리뷰: 코드 리뷰를 통해 들여쓰기 및 스타일 오류를 사전에 방지합니다.

🎯 마무리 및 추가 팁

이 글을 통해 “IndentationError: expected an indented block” 에러의 원인과 해결책을 알아보았습니다. 핵심 내용을 요약하자면, 첫째로 Python의 들여쓰기 규칙을 이해하고, 둘째로 일관된 코드 스타일을 유지하며, 셋째로 자동화 도구를 활용하여 오류를 방지하는 것입니다. 추가 학습 리소스로는 Python 공식 문서와 다양한 온라인 강의를 추천하며, 이 에러를 극복하는 여정에서 여러분을 응원합니다.