できない.dev

Python の IndentationError: unexpected indent が直せない

IndentationError はインデントの幅が前後の行と揃っていない、あるいはタブと空白が混在しているときに出る。
PEP 8 のとおりスペース 4 個に統一し、エディタの可視化機能で混入を見つけるのが最短ルート。

公開: 更新:

症状できない · exit 1
python bad.py
File "/tmp/tmp.MttTZMMZ20/bad.py", line 3
    print("oops")
IndentationError: unexpected indent
解決後できた · exit 0
python good.py
hi world
done

2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細

要約

IndentationError: unexpected indent は、Python パーサが行の先頭インデントを「直前ブロックの規則と矛盾する」と判定したときに発生する。
ルールは 字句解析の Indentation(新しいタブで開く) と PEP 8(新しいタブで開く) に明記されている。
原則は「スペース 4 個に統一」「タブとスペースを混ぜない」の 2 点である。

実行例

実際に python:3.12 環境で余分なインデントを持つスクリプトを実行すると、3 行目で IndentationError: unexpected indent が発生し、終了コード 1 で終了した。
インデントをスペース 4 個に統一した修正版では、hi world と done が出力されて正常に終了した。

$ python bad.py
File "/tmp/tmp.MttTZMMZ20/bad.py", line 3
    print("oops")
IndentationError: unexpected indent
$ echo $?
1
$ python -m tabnanny bad.py
$ echo $?
0
$ python good.py
hi world
done
$ echo $?
0

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
python:3.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. スペース 4 個に統一

def greet(name):
    if name:
        print(f"hi, {name}")
    else:
        print("hi")

エディタの設定で「タブを押したらスペース 4 個を挿入」にしておく。
VS Code なら "editor.insertSpaces": true, "editor.tabSize": 4 を設定する。

2. 空白を可視化して該当行を直す

VS Code: View → Render Whitespace → All (または editor.renderWhitespace: "all") Vim: :set list listchars=tab:>-,trail:·

タブが混入している場合は、エディタの「Convert Indentation to Spaces」コマンドで一括変換できる。

3. 末尾空白を除去

.editorconfig に全行から末尾空白を消す設定を書けば、確実に除去できる。

# .editorconfig
[*.py]
indent_style = space
indent_size = 4
trim_trailing_whitespace = true
insert_final_newline = true

4. python -tt で厳格チェック

python -tt script.py

-tt オプションを付けるとタブ/スペース混在を エラーとして 検出する(-t は警告のみ)。
標準ライブラリの tabnanny(新しいタブで開く) でも同様の検査ができる。

python -m tabnanny script.py

CI に組み込んでおくと、再発を防げる。

よくある原因

  1. コピペした行に余分なインデントが入っている。
    他サイトのコードをそのまま貼ると、行頭にスペースが 1〜2 個余分に入ることがある。
  2. タブとスペースが混在している。
    見た目が同じ 4 文字でも、タブ 1 個とスペース 4 個は Python から見て別物である。
  3. 空行や注釈に末尾空白が残っている。
    一見空に見える行に空白が残っていると、ブロック境界がずれる。
  4. dedent を忘れている。
    関数の中の if を抜けたつもりが、次の return を 1 段深いまま書いている。