PyGuide

Learn Python with practical tutorials and code examples

Complete Tutorial: Python Indentation Error Unexpected Indent Fix

Python indentation error unexpected indent is a fundamental issue that every beginner encounters when learning Python programming. Unlike other programming languages that use braces {} or keywords to define code blocks, Python uses indentation to structure code. This tutorial provides a comprehensive guide to understanding, fixing, and preventing unexpected indent errors.

Understanding Python's Indentation System #

Python uses indentation to define code blocks and scope. Every level of indentation represents a nested block of code:

🐍 Try it yourself

Output:
Click "Run Code" to see the output

What Is "Unexpected Indent" Error? #

The "unexpected indent" error occurs when Python encounters indentation that doesn't follow the established pattern. This error specifically means Python found spaces or tabs where it didn't expect them.

Common Error Messages #

  1. IndentationError: unexpected indent
  2. IndentationError: unindent does not match any outer indentation level
  3. IndentationError: expected an indented block

Root Causes of Unexpected Indent Errors #

1. Mixed Tabs and Spaces #

The most common cause is mixing tabs and spaces for indentation:

# This will cause an error (mixing tabs and spaces)
def calculate_area(length, width):
    area = length * width  # 4 spaces
    return area           # 1 tab character

Error: IndentationError: unindent does not match any outer indentation level

Solution:

# Use consistent spacing
def calculate_area(length, width):
    area = length * width  # 4 spaces
    return area           # 4 spaces

2. Accidental Indentation #

Adding unnecessary indentation at the module level:

# This code has accidental indentation
print("Starting program")
    print("This shouldn't be indented")  # Unexpected indent

Error: IndentationError: unexpected indent

3. Inconsistent Indentation Levels #

Using different numbers of spaces for the same indentation level:

# Inconsistent indentation
def process_data():
  result = []        # 2 spaces
    for i in range(5):  # 4 spaces - inconsistent!
      result.append(i)  # 2 spaces

Step-by-Step Fix Guide #

Step 1: Identify the Problem Line #

When you encounter an indentation error, Python provides the line number:

File "example.py", line 3
    print("This shouldn't be indented")
    ^
IndentationError: unexpected indent

The error points to line 3 as the problematic line.

Step 2: Visual Inspection #

Make whitespace visible in your code editor to see the actual spaces and tabs:

VS Code: View → Render Whitespace
PyCharm: Settings → Editor → General → Appearance → Show whitespaces
Sublime Text: View → Show Console, then type view.settings().set("draw_white_space", "all")

Step 3: Fix the Indentation #

🐍 Try it yourself

Output:
Click "Run Code" to see the output

Step 4: Standardize Your Indentation #

Choose one indentation style and stick to it throughout your project:

Recommended: 4 spaces per indentation level (PEP 8)

# Good: Consistent 4-space indentation
class StudentGrader:
    def __init__(self):
        self.grades = []
    
    def add_grade(self, grade):
        if 0 <= grade <= 100:
            self.grades.append(grade)
        else:
            print("Grade must be between 0 and 100")
    
    def calculate_average(self):
        if self.grades:
            return sum(self.grades) / len(self.grades)
        return 0

Advanced Debugging Techniques #

Using Python's Built-in Tools #

1. The tabnanny Module #

Python provides a built-in tool to detect mixed tabs and spaces:

python -m tabnanny your_file.py

2. AST Parser for Syntax Checking #

🐍 Try it yourself

Output:
Click "Run Code" to see the output

Editor Configuration Best Practices #

Configure your code editor to prevent indentation errors:

VS Code Settings # 

{
    "editor.insertSpaces": true,
    "editor.tabSize": 4,
    "editor.detectIndentation": false,
    "python.linting.enabled": true
}

PyCharm Settings #

  • File → Settings → Editor → Code Style → Python
  • Set Tab size: 4
  • Set Indent: 4
  • Check "Use tab character": False

Common Scenarios and Solutions #

Scenario 1: Copy-Paste from Web Sources #

When copying code from online sources, indentation often gets corrupted:

# Original code (may have mixed indentation)
def web_scraper():
        url = "https://example.com"  # 8 spaces
    response = requests.get(url)     # 4 spaces - error!
        return response.text         # 8 spaces

Fix: Re-indent the entire function consistently:

# Fixed version
def web_scraper():
    url = "https://example.com"  # 4 spaces
    response = requests.get(url)  # 4 spaces
    return response.text          # 4 spaces

Scenario 2: Nested Structures #

Complex nested structures require careful attention to indentation levels:

🐍 Try it yourself

Output:
Click "Run Code" to see the output

Scenario 3: Class Definitions #

Classes require consistent indentation for methods and attributes:

🐍 Try it yourself

Output:
Click "Run Code" to see the output

Prevention Strategies #

1. Establish Coding Standards #

Create a style guide for your project:

  • Use 4 spaces for indentation
  • Never mix tabs and spaces
  • Configure all team members' editors consistently

2. Use Linting Tools #

Install and configure Python linting tools:

# Install flake8 for style checking
pip install flake8

# Check your code
flake8 your_file.py

# Install black for automatic formatting
pip install black

# Format your code automatically
black your_file.py

3. Version Control Hooks #

Set up pre-commit hooks to check indentation before commits:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/psf/black
    rev: 22.3.0
    hooks:
      - id: black
  - repo: https://github.com/pycqa/flake8
    rev: 4.0.1
    hooks:
      - id: flake8

Troubleshooting Checklist #

When encountering unexpected indent errors:

  • Check if tabs and spaces are mixed
  • Verify consistent indentation levels
  • Look at the line above the error
  • Make whitespace visible in your editor
  • Use python -m tabnanny to detect mixed indentation
  • Configure your editor to show indentation guides
  • Consider using automatic code formatters like Black

Summary #

Python indentation error unexpected indent fix for beginners requires understanding Python's indentation-based syntax and following consistent practices. Key takeaways:

  1. Use 4 spaces for each indentation level (PEP 8 standard)
  2. Never mix tabs and spaces in the same file
  3. Configure your editor to show whitespace and use consistent settings
  4. Use tools like tabnanny, linting, and automatic formatters
  5. Practice consistently to develop good indentation habits

Mastering Python indentation is essential for writing clean, readable code. With proper setup and consistent practices, unexpected indent errors become a thing of the past.