Python IndentationError 原因与解决

6次阅读

Python IndentationError 原因与解决

pythonIndentationError 是初学者最常遇到的错误之一,本质是代码缩进不一致或不符合语法规则。Python 用缩进来表示代码块(如 iffor、def、class 等),而不是大括号,所以缩进不是风格问题,而是语法要求。

常见原因:混用空格和 Tab

这是最典型的诱因。编辑器可能显示 Tab 和 4 个空格看起来一样,但 Python 解释器严格区分两者。一旦同一文件中既有 Tab 又有空格(尤其在缩进层级切换时),就会报错:

  • 错误示例:if 语句用 4 个空格,内部 print 却用了一个 Tab;
  • 检查方法:在编辑器中开启“显示空白字符”(如 VS Code 的 “Toggle Render Whitespace”,pycharm 的 “Show Whitespaces”);
  • 解决办法:统一使用 4 个空格(PEP 8 推荐),禁用 Tab 自动转空格功能,或设置编辑器保存时自动将 Tab 转为空格。

缩进层级不匹配

代码逻辑上属于某个代码块,但实际缩进数量与上一级不一致:

  • 错误示例:def 函数体本该缩进 4 空格,某一行却缩进了 3 或 5 个空格;
  • 常见于复制粘贴代码、手动调整缩进、或误删/多加空格;
  • 建议:用编辑器的自动缩进功能(如 VS Code 中选中代码按 Ctrl+Shift+I),避免手动敲空格;
  • 注意:elif/else 必须与对应的 if 对齐,不能更浅也不能更深。

空行或注释后的缩进错误

空行本身不引发错误,但如果空行后下一行缩进“凭空出现”,解释器会困惑:

立即学习Python免费学习笔记(深入)”;

  • 错误示例:if 块结束后换行,再写一个 print,但这个 print 错误地缩进了,Python 会认为它仍属于 if 块;
  • 注释(#)后面的缩进不会被忽略——如果 # 后面跟了空格再跟代码,那些空格仍参与缩进解析;
  • 安全做法:空行后的新代码块,务必确保缩进与逻辑层级严格对应;
  • 写注释尽量独占一行,避免写在行尾导致缩进干扰。

意外的不可见字符

从网页、文档或聊天工具复制代码时,可能带入全角空格、零宽空格、或其它 Unicode 空白符:

  • 这些字符肉眼难辨,但 Python 无法识别为合法缩进;
  • 报错信息通常提示“unexpected indent”或“unindent does not match”,但光标定位困难;
  • 排查方式:删除疑似行的缩进,重新用键盘敲 4 个空格;或用 Python 命令行输入 repr(line) 查看原始字符;
  • 预防:避免直接复制网上代码,优先手打关键结构。
text=ZqhQzanResources