assert在优化模式(-O/-OO)下被忽略,sys.flags.optimize非0可确认;它仅用于开发期逻辑校验,不替代if+raise的错误处理,且消息部分失败时才求值。

assert 在调试时为什么没起作用?
因为 Python 默认可能禁用了断言——运行时加了 -O(优化模式)或 -OO 参数,assert 语句会被直接忽略,连判断都不执行。
- 检查是否误用了
python -O script.py:去掉-O再试 - 在交互式环境(如 IPython、Jupyter)中默认启用,但打包成 exe 或用某些构建工具(如 PyInstaller 加
--onefile --optimize)可能隐式开启优化 -
sys.flags.optimize值为 0 表示未优化,1 或 2 表示 assert 被跳过,可在代码开头加print(sys.flags.optimize)快速确认
assert 和 if raise 的区别在哪?
assert 是开发期轻量验证,不是错误处理机制;if + raise 才是面向用户或生产环境的条件拦截。
-
assert的表达式在优化模式下不求值,比如assert expensive_check(), "slow"在-O下连函数都不会调用,而if会照常执行 - 异常类型固定为
AssertionError,无法指定为ValueError或自定义异常,不利于上层统一捕获分类 - 消息部分(
assert cond, msg中的msg)只在失败时求值,适合放简短提示,别塞日志写入或副作用操作
哪些地方适合写 assert?
只在「开发者能控制输入、且失败说明逻辑有误」的场景下用,比如单元测试前的输入假设、算法中间状态校验、私有函数参数契约。
- 函数开头检查内部调用传参:例如
def _parse_node(node): assert isinstance(node, dict), "node must be dict" - 循环不变量验证:比如二分查找中每次迭代后
assert left - 避免用于文件存在、网络响应、用户输入等外部不可控条件——这些该用
try/except或显式if - 不要在 public API 函数里依赖 assert 做参数校验,调用方无法预期它被关掉
assert 报错信息太模糊怎么办?
默认只打印 AssertionError 和你写的字符串,不带变量值或上下文,调试时得反复加 print —— 直接把关键变量拼进消息里就行。
立即学习“Python免费学习笔记(深入)”;
- 别写
assert x > 0, "x is invalid",改用assert x > 0, f"x={x!r} not positive" - 对复杂结构,用
repr()或切片防输出爆炸:assert len(data) == expected, f"len(data)={len(data)}, expected={expected}, data[:3]={data[:3]}" - 注意字符串格式化本身可能出错(比如
data是 None),所以优先用 f-string 的安全表达式,别在assert消息里调用可能抛异常的方法










