Python TabError — What It Means & How to Fix It

What Does This Error Mean?

A TabError means Python found a mix of tab characters and space characters used for indentation in the same block of code. Python is very strict about indentation — it uses it to understand the structure of your program instead of curly braces. You must pick one style (tabs only, or spaces only) and use it consistently throughout the file.

Affected Models

Python 3.12
Python 3.11
Python 3.10
Python 3.9
Python 3.8

Common Causes

Copying code from a website or document that uses tabs while your editor uses spaces (or vice versa)
Different people editing the same file with different editor settings
Manually pressing Tab on some lines and Space on others
An editor that does not visually distinguish tabs from spaces, making the mix invisible
Pasting code from an AI assistant or IDE into a file with different whitespace settings

How to Fix It

Read the error message. It tells you the exact file name and line number where the mixed indentation was found.

Example: 'TabError: inconsistent use of tabs and spaces in indentation' with a line number — go directly to that line.
Turn on 'show whitespace characters' in your editor. Tabs usually appear as arrows (→) and spaces as dots (·). This makes the mix visible.

In VS Code: View menu → Render Whitespace. In PyCharm: Settings → Editor → General → Appearance → Show whitespaces.
Decide on one style: spaces are strongly recommended by Python's official style guide (PEP 8). Use 4 spaces per indentation level.

Most professional Python code uses 4 spaces. Tabs are not wrong, but spaces are the standard — and you cannot mix them.
Use your editor's 'Convert Indentation to Spaces' feature to fix the whole file at once.

In VS Code: open Command Palette (Ctrl+Shift+P), type 'Convert Indentation to Spaces', press Enter. This fixes the entire file instantly.
If you prefer to fix it manually, delete all whitespace at the start of each problem line and re-indent it using only spaces (or only tabs).

Do not just press Tab or Space over the existing whitespace — delete it first, then re-add the correct indentation.
Configure your editor to always use spaces and never insert tab characters. This prevents the problem from recurring.

In VS Code: Settings → 'Editor: Insert Spaces' → enable. Also set 'Editor: Tab Size' to 4.

When to Call a Professional

TabError is always fixable yourself — it is a whitespace formatting issue, not a logic problem. If your entire codebase has inconsistent indentation, a linter like 'flake8' or 'autopep8' can fix it automatically. Stack Overflow has many guides for configuring VS Code, PyCharm, or other editors to use spaces only.

Frequently Asked Questions

Why does Python care about tabs vs spaces at all? Other languages do not.

Python uses indentation to define code blocks — where most languages use curly braces { }. Because indentation has actual meaning in Python, the interpreter must be able to measure it precisely. A tab could mean 4 spaces or 8 spaces depending on the editor, so mixing tabs and spaces creates ambiguity that Python refuses to guess at.

The lines look perfectly aligned in my editor — how can there be a TabError?

Tabs and spaces can look identical in most editors because a tab simply jumps to the next 4-space (or 8-space) boundary. The file content is different even though the visual result looks the same. Enable 'show whitespace characters' in your editor to see the difference.

Is there a quick way to fix TabError in an entire project?

Yes — run 'autopep8 --in-place --aggressive filename.py' from the command line to auto-fix one file. For a whole project, install autopep8 with 'pip install autopep8' and run it on each file. Most modern editors can also do this in one click via their formatting commands.