Python 报错 IndentationError: unexpected indent 的原因及解决方案

在 Python 编程中，缩进错误 (IndentationError) 是新手开发者常遇到的问题之一。Python 依赖代码缩进来确定代码块的层次结构，因此一旦缩进不符合规范，就会抛出 IndentationError: unexpected indent 错误。本文将详细分析该错误的可能原因，并提供相应的解决方案。

一、IndentationError: unexpected indent 的常见原因

1.1 不一致的缩进风格

Python 允许使用空格或制表符（Tab）进行缩进，但不能混用。在同一代码块中，必须统一使用空格或 Tab 进行缩进，否则会引发缩进错误。

示例：

def example_function():
    print("This is a correct line")
        print("This line has an unexpected indent")

上面的代码中，第二行代码多缩进了一个空格或 Tab，导致 Python 无法正确解析，抛出 IndentationError: unexpected indent。

解决方案：
确保在同一代码块内只使用一种缩进方式，建议统一使用 4 个空格作为缩进。

1.2 文件中包含隐形字符

有时，文件中可能包含不可见的特殊字符（如非标准空格字符、BOM 标记等），这些字符可能导致缩进解析出错，即使看起来代码缩进正常。

示例：

def another_function():
    print("This line seems correct but may contain invisible characters")

虽然上面的代码看似正确，但如果其中包含不可见的特殊字符，依然会导致缩进错误。

解决方案：
使用文本编辑器或 IDE 的功能来显示不可见字符，并确保只使用标准的空格或 Tab 进行缩进。

1.3 手动缩进与 IDE 自动缩进的冲突

不同的编辑器或 IDE 可能对缩进有不同的默认配置，如果在不同的环境中编辑代码，可能会导致缩进不一致。例如，在一个编辑器中使用 Tab，而在另一个编辑器中使用空格，可能导致缩进混乱。

解决方案：
检查并统一 IDE 或编辑器的缩进配置。大多数 IDE 都允许设置缩进方式（如将 Tab 转换为空格）：

• 在 VSCode 中，可以通过设置 "editor.tabSize": 4 和 "editor.insertSpaces": true 来确保使用 4 个空格代替 Tab。
• 在 PyCharm 中，可以通过 Editor -> Code Style -> Python 设置缩进规则。

1.4 不正确的缩进层次

Python 通过缩进来表示代码块的层次结构，代码块的开始与结束是通过缩进级别的变化来表示的。如果代码块的缩进层次不符合逻辑，会导致 unexpected indent 错误。

示例：

def check_number(num):
    if num > 0:
        print("Positive number")
    print("This line should be indented to match the if block")

在上面的代码中，最后一行应该与 if 语句对齐，但它没有正确缩进，导致错误。

解决方案：
确保代码块的缩进层次正确，所有属于同一逻辑块的代码行必须缩进相同的空格或 Tab。

二、如何排查和修复 IndentationError

1. 检查代码中的缩进不一致：
   仔细检查所有缩进，确保整个代码文件中统一使用空格或 Tab，而不是混合使用。

2. 使用自动格式化工具：
   使用 Python 社区推荐的代码格式化工具（如 black 或 autopep8）来自动修复缩进问题。它们会根据 PEP 8 规范格式化代码，确保缩进一致。

   安装 black：

   pip install black

   使用 black 格式化代码：

   black your_script.py

3. 显示不可见字符：
   使用支持显示不可见字符的文本编辑器或 IDE 来检查代码中是否包含非标准的缩进字符或其他不可见的特殊字符。
4. 手动检查代码结构：
   如果自动工具无法解决问题，手动检查代码块的缩进逻辑，确保所有代码块的开始和结束位置正确。
5. 重置缩进：
   在代码行前重新删除所有缩进，然后手动添加正确的缩进级别，确保没有任何隐藏字符或缩进格式问题。

三、思维导图

Python IndentationError: unexpected indent 报错原因与解决方案
    1. 常见原因
        1.1 不一致的缩进风格
        1.2 文件中包含隐形字符
        1.3 手动缩进与 IDE 自动缩进冲突
        1.4 不正确的缩进层次
    2. 排查与修复
        2.1 检查代码中的缩进不一致
        2.2 使用自动格式化工具
        2.3 显示不可见字符
        2.4 手动检查代码结构
        2.5 重置缩进

四、总结

IndentationError: unexpected indent 是 Python 中的常见报错，通常由缩进不一致、文件中存在隐形字符、不同编辑器的缩进规则冲突或代码块缩进层次不正确引起。通过统一缩进风格、使用自动格式化工具以及手动检查代码结构，可以有效解决此类错误。在开发过程中，遵循 PEP 8 规范的代码风格有助于减少缩进相关的问题。