None是Python中表示“无对象”的单例标记,非空值或假值;误用会导致TypeError/AttributeError,应使用is None判断、避免可变默认参数,并在类型提示中用Optional明确标注。
None 不是空值,而是“无对象”的显式标记
Python 里
的本质是一个单例对象,类型为
,它不表示“空”“零”或“假”,只表示“这里没有值”。很多人误用
替代空字符串、空列表或默认数值,结果在后续逻辑中触发
或
(比如对
调用
或
)。
常见错误现象:
- 函数没写
,却默认返回
,调用方误以为有返回值
- 用
判断(应改用
)
- 把
当作布尔上下文中的“安全假值”,忽略它和
、
、
的语义差异
实操建议:
- 显式返回
仅当“无意义结果”是接口契约的一部分(如
)
- 检查是否为
时,始终用
或
- 避免让函数“有时返回值,有时返回
”,这类设计会迫使调用方反复做存在性检查
函数参数默认值设为 None 是为了区分“未传参”和“传了空值”
把参数默认设为
(而非
或
),核心目的是规避可变默认参数陷阱。例如
中,
在每次调用时都能安全地初始化为新列表(
或更严谨的
)。
使用场景:
- 需要支持“不传该参数”与“传了但值为空”两种语义(如配置覆盖、缓存跳过)
- 构造器中某些字段可选,且其默认行为依赖运行时状态(如连接池初始化时是否复用已有连接)
注意点:
- 不要写
—— 这个
是函数对象的属性,跨调用共享
- 若参数语义上“必须非空”,就别用
做默认值,直接不设默认或抛
- 使用
标注时,要同步更新文档说明
的业务含义(比如“跳过校验”还是“使用全局配置”)
None 在类型提示和静态检查中的真实作用
实际等价于
,但它不是给运行时用的,而是给
、
这类工具看的。运行时这些提示完全被忽略,所以光加类型注解不处理
分支,照样会崩。
实操建议:
- 在启用类型检查的项目中,所有可能为
的变量/返回值都应标注
- 用
或
主动收口,避免靠侥幸躲过
流入下游
- 注意
和
(Python 3.10+)等价,但老版本只能用前者;混用时容易漏掉兼容性检查
性能影响几乎为零,但忽略它会让类型系统失效——比如
看到
却没见你处理
,就会报错,这不是限制,是提醒你漏了分支。
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
立即学习
“
Python免费学习笔记(深入)
”;
None 和其他“假值”混用时最易出问题的边界
在条件判断中,
、
、
、
、
、
全部为假,但它们代表的含义天差地别。把
当成“x 为空”的万能判断,是很多 bug 的源头。
典型踩坑场景:
- API 返回
,
前端
用
判定有数据,结果
被当成“无数据”
- 数据库字段允许 NULL,ORM 映射后变成
,但业务代码用
判断,直接抛
-
配置文件
里
解析为
,却被当成 0 秒超时
正确做法:
- 明确你要检测的是“是否存在”(
)、“是否为空集合”(
)、还是“是否为逻辑假”(
)
- 对外部输入(API、DB、配置)做标准化封装,把
转成明确的缺省值(如
表示“无超时”),或统一抛异常
- 在单元测试中,必须覆盖
输入路径,尤其注意它和空字符串、零值的交互逻辑
最常被忽略的一点:
是合法的字典键、集合元素、JSON 序列化值(
),但它不能参与算术、比较(
报
)、或任何需要具体类型的运算。边界不在语法,而在你是否清楚每个操作对值类型的隐含假设。
Nonetype(None)NoneAttributeErrorTypeErrorNone.append()+returnNoneif x == None:is NoneNoneFalse0""Nonelist.remove()Noneis Noneis not NoneNoneNone[]{}def f(x, items=None):itemsitems = items or []items = [] if items is None else itemsdef f(items=[]):[]NoneTypeErrortyping.OptionalNoneOptional[T]Union[T, None]mypypyrightNoneNoneOptionalassert x is not Noneif x is None: raise ...NoneOptional[str]str | NonemypyOptional[int]NoneNoneFalse0""[]{}if not x:{"data": None}if (res.data)NoneNonelen(x) == 0TypeError"timeout": nullNoneis Nonelen(x) == 0not xNone-1NoneNonejson.dumps(None) → "null"None > 0TypeError