できない.dev

Python「TabError: inconsistent use of tabs and spaces in indentation」の原因と直し方

TabError: inconsistent use of tabs and spaces は、同じブロックでタブとスペースが混ざると出る。
インデントをスペース 4 つに統一し、エディタでタブをスペースに変換すれば直る。

公開: 更新:

症状できない · exit 1
python script.py
File "/tmp/tmp.WnXD2MsjyS/script.py", line 3
    y = 2
TabError: inconsistent use of tabs and spaces in indentation
解決後できた · exit 0
python -m tabnanny script.py
script.py 3 '\ty = 2'

2026-09-01 に python:3.12(Python 3.12.14) で実際に打って取った出力。検証環境の詳細

要約

TabError: inconsistent use of tabs and spaces in indentation は、同じインデントブロックの中でタブとスペースが混ざっていて、Python がインデント幅を一意に決められないときに出る。

Python 3 はタブとスペースの混在を曖昧として拒否する。
見た目では揃っていても文字種が違うと発生するので、インデントをスペースに統一すれば確実に直る。

実行例

cat -A で見ると、スペース 4 つの行の次にタブ始まりの行がある。
実行すると 3 行目で TabError になり、終了コードは 1 になる。
python -m tabnanny は落ちた行をそのまま指し示し、expand -t 4 でタブを空白に展開したファイルは py_compile を通る。

$ cat -A script.py
if True:$
    x = 1$
^Iy = 2$
$ python script.py
File "/tmp/tmp.WnXD2MsjyS/script.py", line 3
    y = 2
TabError: inconsistent use of tabs and spaces in indentation
$ echo $?
1
$ python -m tabnanny script.py
script.py 3 '\ty = 2'
$ echo $?
0
$ expand -t 4 script.py > fixed.py
$ cat -A fixed.py
if True:$
    x = 1$
    y = 2$
$ python -m py_compile fixed.py
$ echo $?
0

— 2026-09-01 時点の出力

検証環境Python 3.12.14 / Git 2.47.3 / 2026-09-01 検証
検証日
実行環境
python:3.12 Debian GNU/Linux 13 (trixie)
バージョン
  • Python 3.12.14
  • Git 2.47.3

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

解決策

1. 混在を可視化する

cat -A script.py | head

タブは ^I、行末は $ で表示されるので、どの行がタブ/スペースかを目視できる。

2. インデントをスペース 4 に統一する

エディタ設定を .editorconfig で固定すると再発しにくい。

[*.py]
indent_style = space
indent_size = 4

3. 不整合を検出する

python -m tabnanny script.py

標準ライブラリの tabnanny が、曖昧なインデントを行番号付きで報告する。

4. まとめて変換する

expand -t 4 script.py > fixed.py

タブを 4 スペースへ展開する。
差分を確認してから元ファイルへ反映する。

よくある原因

  1. ブロック内でタブとスペースが混在している。
    上の行はタブ、下の行はスペース、のように行ごとに文字種が違う。
  2. エディタの設定が合っていない。
    Tab キーがタブ文字を挿入する設定で、スペース基準の既存コードに追記した。
  3. コピペでインデントが混ざった。
    貼り付けた行だけ、インデント文字が異なる。