Python 缩进错误：原因、避免与调试-Python教程-PHP中文网

Python 缩进错误：原因、避免与调试

DDD

发布： 2025-10-01 20:11:00

原创

210人浏览过

python 缩进错误：原因、避免与调试

本文旨在帮助 Python 初学者理解并避免常见的“Expected indented block”错误。通过分析错误原因、提供正确的缩进示例，以及介绍如何利用编辑器或IDE来解决缩进问题，帮助读者编写出更规范、更易读的 Python 代码。

Python 是一种对缩进非常敏感的语言。这意味着代码块的开始和结束不是通过大括号或其他符号来标记，而是通过缩进来区分。如果缩进不正确，Python 解释器就会报错，其中最常见的错误之一就是 "Expected indented block"。

错误原因分析

"Expected indented block" 错误通常发生在以下几种情况：

缺少缩进： 在需要缩进的代码块（例如 if 语句、for 循环、while 循环、函数定义等）中，忘记添加缩进。
缩进不一致： 同一个代码块中的所有行必须具有相同的缩进级别。如果缩进量不一致，Python 解释器会认为代码块结构混乱。
混用空格和制表符： Python 允许使用空格或制表符进行缩进，但不允许在同一个文件中混用。混用会导致缩进看起来正确，但实际上 Python 解释器无法正确识别。

正确的缩进示例

以下是一个使用 pygame 库的简单示例，展示了正确的缩进方式：

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

因赛AIGC

因赛AIGC解决营销全链路应用场景

查看详情

import pygame as pg

pg.init() # 初始化pygame

# 设置窗口大小
screen_width = 800
screen_height = 600
screen = pg.display.set_mode((screen_width, screen_height))

# 游戏主循环
run = True
while run:
    # 事件处理
    for event in pg.event.get():
        # 退出程序
        if event.type == pg.QUIT:
            run = False

    # 填充背景色
    screen.fill((255, 255, 255)) # 白色

    # 更新显示
    pg.display.flip()

pg.quit() # 退出pygame

登录后复制

在这个例子中，while 循环下的所有代码都缩进了 4 个空格。for 循环下的代码以及 if 语句下的代码也都相应地进行了缩进。

注意：

通常建议使用 4 个空格作为标准的缩进量。
每个代码块的缩进级别应该比其父代码块高一级。

如何避免和解决缩进错误

始终使用空格或始终使用制表符： 在一个 Python 项目中，坚持只使用空格或者只使用制表符进行缩进。推荐使用空格，因为空格在不同的编辑器和平台上的显示效果更一致。
配置你的编辑器或 IDE： 大多数代码编辑器和集成开发环境 (IDE) 都可以配置为自动将制表符转换为空格。这可以有效地避免混用空格和制表符的问题。常见的配置包括：
- 将 Tab 键设置为空格： 确保你的编辑器在按下 Tab 键时插入的是空格，而不是真正的制表符。
- 自动缩进： 启用自动缩进功能，编辑器会在你输入冒号后自动进行缩进。
- 显示空白字符： 开启显示空白字符的选项，可以让你清楚地看到代码中的空格和制表符，从而更容易发现潜在的缩进问题。
使用代码检查工具： 像 flake8 或 pylint 这样的代码检查工具可以帮助你发现代码中的缩进错误以及其他潜在的问题。
仔细检查错误信息： 当 Python 解释器报错 "Expected indented block" 时，仔细阅读错误信息，确定出错的行数，然后检查该行及其周围的代码，看看是否存在缩进问题。
养成良好的编码习惯： 在编写代码时，时刻注意缩进，确保代码块的结构清晰。