IndentationError・TabErrorの直し方｜Python

IndentationError は、Python のインデント（行頭の字下げ）が、文の構造と合っていないときのエラーです。 メッセージは4種類あり、それぞれ直す場所が違います。

見た目ではそろっているのにエラーになるときは、ほとんどがタブとスペースの混在です。エディタの画面では区別できないので、下のコマンドで確かめます。

確認環境：Python 3.10・3.12・3.13・3.14（確認日 2026年10月11日）。

unindent does not match any outer indentation level

def f(x):
    if x:
        print("a")
      print("b")        # ← 6文字。4（if の深さ）でも 8（print("a") の深さ）でもない

  File "unindent.py", line 4
    print("b")
              ^
IndentationError: unindent does not match any outer indentation level

字下げを戻すときは、それまでに使った深さ（0・4・8）のどれかに、ぴったり戻す必要があります（Python の言語リファレンス）。6文字はどれとも一致しないのでエラーです。^ の位置は、行の最後を指すことがあり、当てになりません。エラーの行の行頭を見ます。

クラスの中のメソッドを1文字ずれて書いたときも、同じエラーになりました。

class A:
    def m(self):
        return 1
   def n(self):          # ← 3文字
        return 2

expected an indented block

def f(x):
    if x:
    print("a")           # ← if の中なのに、if と同じ深さ

IndentationError: expected an indented block after 'if' statement on line 2

Python 3.10 以降は、after 'if' statement on line 2 のように、どの文の中身が無いかを表示します。 3.13 以降は ^^^^^ で範囲も示されました。

中身がコメントだけでも出る

def f():
    # TODO あとで書く

print(1)

IndentationError: expected an indented block after function definition on line 1

コメントは中身として数えられません。 あとで書くつもりの関数・if には、pass を書いておきます。

unexpected indent

x = 1
    print(x)             # ← 字下げする理由が無い

IndentationError: unexpected indent

ほかの場所からコードをコピーして貼り付けたときに多いエラーです。貼り付けた部分全体の字下げを、周りに合わせます。

TabError と、見た目はそろっているのに出るエラー

$ cat -A tab.py
def f(x):$
    if x:$
^Iprint("a")$                ← ^I がタブ
        print("b")$

  File "tab.py", line 3
        print("a")
    ^
TabError: inconsistent use of tabs and spaces in indentation

エディタでタブの幅が4文字だと、3行目は if と同じ深さに、8文字だと4行目と同じ深さに見えます。 Python は、タブの幅によって意味が変わる書き方を、TabError にします（言語リファレンス）。

エラーにならない混在もあるので、「今まで動いていたのに、1行足したら TabError」ということが起きます。ファイル全体を、どちらかにそろえておきます。Python のスタイルガイド（PEP 8）では、インデントはスペース4つが推奨です。

タブを見つける方法

$ python3 -m tabnanny -v tab.py
'tab.py': *** Line 3: trouble in tab city! ***
offending line: '\tprint("a")\n'
indent not greater e.g. at tab sizes 1, 2, 3, 4

$ python3 -m tabnanny p8              ← フォルダーを指定すると、中のファイルをまとめて調べる
p8/tab.py 3 '\tprint("a")\n'
'p8/unindent.py': Indentation Error: unindent does not match any outer indentation level (<tokenize>, line 4)

tabnanny は、TabError になる行だけでなく、IndentationError のファイルも一覧にしました。 プロジェクト全体を一度に調べられます。

タブをスペースに変えるときの注意

$ expand -t 4 tab.py > tab_fixed.py
$ cat -A tab_fixed.py
def f(x):$
    if x:$
    print("a")$                 ← if と同じ深さになった
        print("b")$
$ python3 tab_fixed.py
IndentationError: expected an indented block after 'if' statement on line 2

タブを機械的にスペース4つに変えると、別のエラーになりました。 書いた人の意図（3行目は if の中か）は、ファイルからは分からないためです。変換したあとは、エラーの行を目で見て、意図した深さに直します。エディタの「インデントをスペースに変換」の機能でも同じです。

エディタの設定で防ぐ

確認の手順（チェックリスト）

よくある質問

Q. Jupyter Notebook や、ブラウザからコピーしたコードで出ます。 A. コピー元によっては、字下げにタブや、ノーブレークスペース（U+00A0）などの特殊な空白が混ざります。特殊な空白は IndentationError ではなく SyntaxError: invalid non-printable character U+00A0 になります。全角スペースの場合も含め、関連記事の「SyntaxError: invalid characterの直し方｜全角スペース」で扱っています。

まとめ

• 4種類のメッセージで、直す場所が違う
• unindent は、それまでの深さのどれにも戻っていない
• expected は、中身が無い（コメントだけでも出る。pass を書く）
• 見た目はそろっているのに出るのは、タブとスペースの混在。cat -A と tabnanny で見つける
• 混在しても動くことがあるので、1行足して突然出る。スペース4つにそろえる
• タブを機械的に変換すると、意味が変わることがある。変換後に目で確かめる

参考・出典

確認日はいずれも 2026年10月11日です。

• Python ドキュメント「Lexical analysis」（Indentation）：https://docs.python.org/3/reference/lexical_analysis.html
• Python ドキュメント「tabnanny — Detection of ambiguous indentation」：https://docs.python.org/3/library/tabnanny.html
• PEP 8「Style Guide for Python Code」：https://peps.python.org/pep-0008/

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。