assert是Python中专用于开发调试的轻量级断言机制,用于快速验证“此处本应为真”,失败时抛出AssertionError中断执行;适用于函数入口参数检查、算法中间状态确认、重构防护及单元测试,但不可替代if或异常处理,且启用-O优化时会被完全忽略。

assert 是 Python 中用于调试和开发阶段的轻量级断言机制,不是用来处理运行时错误或用户输入校验的,它的核心作用是:在代码中快速检查“这里本应为真”,一旦不成立就立即中断并报错,帮你快速定位逻辑问题。
什么时候该用 assert
适合在以下场景主动插入 assert,作为开发者的“思维锚点”:
- 函数入口处验证参数是否符合内部假设(比如“这个列表绝不能为空”)
- 算法关键步骤后确认中间状态(比如“排序后第一个元素应该 ≤ 最后一个”)
- 重构或加新逻辑时,临时加断言防止破坏原有行为
- 单元测试中配合 pytest 或 unittest 使用,但注意它不如专用断言方法(如
assertEqual)信息丰富
怎么写有效的 assert
避免只写 assert condition 这种无提示的写法。加上描述性消息,出错时一眼看懂哪里破了:
assert len(items) > 0, f"预期 items 非空,但实际长度为 {len(items)}"
也可以用括号分多行提升可读性:
立即学习“Python免费学习笔记(深入)”;
assert (isinstance(user, dict) and
'name' in user and
'age' in user), "user 必须是含 name 和 age 的字典"
assert 不是异常处理,也不能替代 if
它和 if not condition: raise ValueError(...) 有本质区别:
-
assert在 Python 启动时加-O(optimize)参数会被完全忽略——上线部署通常会启用,所以它不具备运行保障能力 - 它抛出的是
AssertionError,不是业务异常类型,不适合被try/except捕获来控制流程 - 不要用它校验用户输入、文件是否存在、网络响应等外部不确定因素;这些该用显式判断 + 适当异常
调试时怎么配合 assert 提效
在 IDE(如 PyCharm、VS Code)中,assert 失败会自动停在出错行,配合变量面板能立刻看到上下文值。你还可以:
- 把 assert 当作“临时断点”:比打普通断点更语义化,且能同时验证+中断
- 在循环里加 assert 看某次迭代是否触发异常状态(注意别放太里面,避免频繁中断)
- 配合日志关闭策略:开发期开 assert,上线前通过 -O 自动剔除,无需手动删代码










