TabError是因混用Tab和空格缩进而致，Python无法统一解析缩进层级；需用编辑器显示空白字符定位、工具（如autopep8）统一修复，并通过.editorconfig和编辑器设置强制规范缩进。

TabError: inconsistent use of tabs and spaces in indentation 是什么

这个错误不是说你用了 Tab 或空格，而是混用了——比如某行用 2 个空格缩进，下一行却用 1 个 Tab（等价于 4 或 8 个空格，取决于编辑器设置），Python 解释器无法统一解析缩进层级，直接报错中断执行。

怎么快速定位混用位置

别靠肉眼扫，Python 的 TabError 通常只提示出错行号，但问题往往在上一行或更早的缩进块里。推荐以下方法：

• 用 python -m py_compile your_script.py 提前编译，比直接运行更容易暴露真实缩进断点
• 在 VS Code / PyCharm 中开启「显示空白字符」（通常叫 Show Whitespace 或 Render Whitespace），Tab 显示为 →，空格显示为 ·，一眼就能看出混用
• 终端下用 cat -A your_script.py | head -n 20 查看前 20 行：Tab 会显示为 ^I，空格就是普通空格，方便确认

如何一次性修复已有文件的缩进混乱

手动改容易漏，尤其大文件。用工具强制统一最稳妥：

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

• VS Code：选中全部代码 → 右键 → Format Document With... → 选 autopep8 或 black（前提是已安装）；或者快捷键 Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）
• 命令行用 autopep8 --in-place --aggressive --aggressive your_script.py，它默认把所有缩进转成 4 空格
• 如果只想替换 Tab 而不改动其他格式，用 sed -i 's/^\t/ /g' your_script.py（Linux/macOS），但注意这仅处理行首 Tab，不保证整文件一致性

怎么避免下次再出现

关键不在“记得换空格”，而在让编辑器替你守规矩：

立即学习“Python免费学习笔记（深入）”；

• VS Code：在设置里搜 insertSpaces，勾选；再搜 detectIndentation，**取消勾选**（否则它会根据文件头自动切 Tab/空格，反而埋雷）；tabSize 设为 4
• PyCharm：Settings → Editor → Code Style → Python → Tabs and Indents → 勾选 Use tab character **取消勾选**，Tab size、Indent、Continuation indent 全设为 4
• 加个保险：在项目根目录放 .editorconfig 文件，内容写：

  [*.py]
  indent_style = space
  indent_size = 4

  多数现代编辑器会自动读取它

真正麻烦的不是修一次缩进，是团队协作时有人开 Tab、有人开空格，又没配 .editorconfig，几轮提交后整个文件缩进就变成迷宫。提前统一体验成本，远低于后期 debug TabError 时反复翻 Git blame。