Python 缩进问题：IndentationError 缩进错误

Python 用缩进来划分代码块，而不是像其他语言那样使用大括号 {}。这意味着空格或制表符的数量必须严格一致，否则会触发 IndentationError。这个错误是初学者最常见的报错之一，但只要掌握规则，就能轻松避免和修复。

识别典型的 IndentationError

当你运行 Python 脚本时，如果看到类似以下的报错信息：

IndentationError: unexpected indent
IndentationError: unindent does not match any outer indentation level
IndentationError: expected an indented block

说明你的代码在缩进上出现了问题。不要忽略这些错误——它们不是警告，而是直接导致程序无法运行的语法错误。

理解 Python 的缩进规则

1. 缩进表示代码从属关系。例如，在 if、for、while、def、class 等语句后，下一行必须缩进，表示“这是该结构内部的代码”。
2. 同一代码块内的所有行必须缩进相同数量的空格（或制表符）。
3. Python 官方推荐使用 4 个空格作为一级缩进（PEP 8 规范）。
4. 严禁混用空格和制表符。这是导致 unindent does not match... 错误的最常见原因。

修复缩进错误的实操步骤

第一步：统一使用空格（强烈推荐）

打开你的代码编辑器，并设置为“按 Tab 键时插入 4 个空格”。具体操作因编辑器而异：

• VS Code：点击右下角 Tab Size: 4 → 选择 "Convert Indentation to Spaces"
• PyCharm：File → Settings → Editor → Code Style → Python → 勾选 "Use tab character" 的反选项（即不勾选），确保 "Tab size" 和 "Indent" 都设为 4
• Sublime Text：View → Indentation → 取消勾选 "Use Tabs"，勾选 "Indent Using Spaces"，并将 "Tab Width" 设为 4

完成设置后，按下 Tab 键将自动输入 4 个空格，而不是一个制表符。

第二步：检查并清理现有代码中的混合缩进

复制以下命令到终端，检测文件中是否混用了空格和制表符（适用于 Linux/macOS）：

grep -n $'\t' your_script.py

如果输出行号，说明这些行含有制表符。手动将这些行的开头制表符替换为 4 的倍数个空格。

在 Windows PowerShell 中可使用：

Select-String -Path "your_script.py" -Pattern "`t"

第三步：逐级对齐缩进层级

以一个典型错误为例：

def calculate(a, b):
if a > b:
print("a is larger")
else:
print("b is larger or equal")
result = a + b
return result

这段代码会报 expected an indented block，因为 if 语句后没有缩进。

修正方法如下：

1. 在 if 行下方插入 4 个空格，使 print("a is larger") 缩进
2. 同样为 else 下方的 print 缩进 4 个空格
3. result = a + b 和 return result 属于函数体，但不在 if/else 内，所以缩进应与 if 对齐（即 4 个空格）

修正后的正确代码：

def calculate(a, b):
    if a > b:
        print("a is larger")
    else:
        print("b is larger or equal")
    result = a + b
    return result

注意：if 和 else 是同一级，都缩进 4 空格；它们内部的 print 再缩进 4 空格（共 8 空格）；函数最后两行与 if 对齐。

第四步：处理多层嵌套结构

对于嵌套循环或条件判断，每进入一层新结构，就增加 4 个空格；退出一层，就减少 4 个空格。

例如：

for i in range(3):
    for j in range(2):
        if i == j:
            print(f"Match: {i}, {j}")
        else:
            print(f"No match: {i}, {j}")
    print("End of inner loop")
print("All done")

缩进层级：

• for i...：0 空格
• for j... 和最后的 print("End of inner loop")：4 空格
• if/else：8 空格
• print(f"...")：12 空格

始终确保同级语句左对齐。

常见陷阱与避坑指南

自动化检测与预防

安装并运行 flake8 工具，它能自动检查缩进和其他代码风格问题：

pip install flake8
flake8 your_script.py

如果输出包含 E111（缩进不是 4 的倍数）、E101（混用空格和 Tab）等错误码，根据提示修正对应行号的缩进。

你还可以在编辑器中启用实时检查插件（如 VS Code 的 Python 扩展），在编写时就高亮显示缩进异常，做到即时纠正。

特殊情况处理

空函数或空代码块

如果你暂时不想写函数体，不要留空行，而应使用 pass 占位：

def placeholder():
    pass

如果写成：

def placeholder():

会报 expected an indented block，因为 Python 要求冒号后必须有缩进内容。

多行表达式续行

当一行代码太长需换行时，在括号 ()、方括号 [] 或花括号 {} 内换行无需额外缩进，但建议对齐：

total = (a +
         b +
         c)

或者显式缩进：

total = a + \
        b + \
        c

注意：使用反斜杠 \ 续行时，下一行必须缩进，否则可能被误认为新语句。

始终记住：Python 的缩进不是风格选择，而是语法要求。保持一致性，统一使用 4 个空格，禁用 Tab，就能彻底告别 IndentationError。