Skip to content

TabError:制表符和空格使用不一致

快速摘要

你的文件在同一块中同时使用制表符和空格缩进 —— Python 无法确定缩进级别并抛出 TabError。

为什么发生

  • 某些行使用制表符而其他行使用空格在同一函数或块中缩进

  • 编辑器在你期望插入空格时插入了制表符(或相反)

  • 来自不同来源的代码使用不同缩进风格粘贴到同一文件

最小示例

✗ 错误代码
def f():
	if True:
	    print('mixed')  # tab then spaces = TabError
✓ 修复代码
def f():
    if True:
        print('aligned')  # all spaces, 4 each

所有缩进只使用空格(每级 4 个)可消除导致 TabError 的歧义。

如何诊断

  • 运行 python -tt yourfile.py 将制表符/空格混用检测为带行号的错误

  • 用 cat -A 或 expand -t 4 可视化文件中的制表符并找到混合缩进

  • 配置编辑器显示空格并识别哪些行使用制表符或空格

如何修复

  • 用 expand -t 4 yourfile.py 或编辑器的制表符转空格功能将所有制表符转为空格

  • 配置编辑器在按 Tab 时插入空格并设置制表符宽度为 4

  • 用一致的制表符或空格(建议空格)重新缩进问题块

如何预防

  • 设置编辑器使用空格缩进,永不插入字面制表符

  • 添加 .editorconfig 文件设置 indent_style = space 和 indent_size = 4 强制一致缩进

相关资源

相关术语

相关课程

← 返回语言