
Python 的 IndentationError 是初学者最常遇到的错误之一,本质是代码缩进不一致或不符合语法规则。Python 用缩进来表示代码块(如 if、for、def、class 等),而不是大括号,所以缩进不是风格问题,而是语法要求。
常见原因:混用空格和 Tab
这是最典型的诱因。编辑器可能显示 Tab 和 4 个空格看起来一样,但 Python 解释器严格区分两者。一旦同一文件中既有 Tab 又有空格(尤其在缩进层级切换时),就会报错:
- 错误示例:if 语句用 4 个空格,内部 print 却用了一个 Tab;
- 检查方法:在编辑器中开启“显示空白字符”(如 VS Code 的 “Toggle Render Whitespace”,PyCharm 的 “Show Whitespaces”);
- 解决办法:统一使用 4 个空格(PEP 8 推荐),禁用 Tab 自动转空格功能,或设置编辑器保存时自动将 Tab 转为空格。
缩进层级不匹配
代码逻辑上属于某个代码块,但实际缩进数量与上一级不一致:
phpweb1.0基于php+mysql+smarty开发的企业解决方案,总体感觉简洁快速,适合小型企业的建站方案,也适合初学者学习。 之前发布过phpweb1.0的原始版本,仅提供大家交流和学习,但很多的爱好者提出了一些不足和好评,本不想继续开发1.0,因为2.0已经开发完毕而且构架与1.0完全不同,但是有些使用者喜欢这种简洁和简便,应大家的要求,美化和优化了一些不足之处。后台更加简洁美观。
- 错误示例: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)查看原始字符; - 预防:避免直接复制网上代码,优先手打关键结构。









