因为可变对象作默认参数会在函数定义时创建一次并被所有调用共享,导致修改污染后续调用;正确做法是用None占位并在函数体内初始化新对象。

为什么 list 或 dict 不能当默认参数用
因为函数定义时,def f(x=[]) 中的空列表只创建一次,后续所有调用共享同一个对象。修改它(比如 .append())会污染下一次调用的结果——这不是“默认值”,是“缓存引用”。
常见错误现象:f(); f() 返回 [1]、[1, 1] 而非两个独立的 [1]。
- 所有默认参数在函数定义时求值,不是每次调用时
-
list、dict、set等可变对象一旦被修改,就永久改变该默认值实例 - 不可变对象如
None、0、""没这个问题,但它们也不能直接用于需要初始化容器的场景
正确写法:用 None 占位 + 函数体内初始化
把可变默认值的逻辑移到函数体内部,用 None 作为“未传参”的信号,再按需创建新对象。
def append_item(item, items=None):
if items is None:
items = []
items.append(item)
return items
这样每次调用都拿到干净的新列表。注意必须用 is None 判断,不用 == None(虽然通常等效,但语义和性能更准)。
- 不要写
if not items:—— 若传入空列表[],也会误判为“未传” - 若想支持传入
False、0、""等假值且仍保留默认行为,is None是唯一可靠方式 - 如果默认值较重(如读文件、建连接),可考虑加缓存逻辑,但那是另一层问题
类方法中如何安全处理可选列表参数
类方法同样适用上述规则,但要注意避免把可变默认值塞进 self 属性里造成实例间污染。
class Processor:
def __init__(self, cache=None):
self.cache = cache if cache is not None else {}
<pre class="brush:php;toolbar:false;">def add(self, key, value, tags=None):
if tags is None:
tags = []
self.cache[key] = {"value": value, "tags": tags}重点:即使 cache 是字典,也得用 None 初始化;否则多个 Processor() 实例可能意外共享同一字典。
- 别在
__init__参数里写cache={}或tags=[] - 若想让类支持“全局默认配置”,应显式定义类变量(如
DEFAULT_TAGS = []),但注意类变量本身仍是可变对象——除非你真要共享,否则依然推荐实例内新建 - 对用户暴露的 API 方法,比内部逻辑更需严守这条规则,因为调用方无法控制你的默认值生命周期
用 functools.partial 替代默认参数的特殊情况
当你需要预设部分参数、又不想触发可变默认陷阱时,partial 是更清晰的选择——它不涉及函数定义时的默认值求值。
from functools import partial
<p>def send_request(url, method="GET", headers=None, data=None):
if headers is None:
headers = {}</p><h1>...</h1><h1>安全地封装一个常用变体</h1><p>post_json = partial(send_request, method="POST", headers={"Content-Type": "application/json"})
</p>
这里 headers 在 post_json 被调用时才生成,不会提前固化。
-
partial适合封装固定参数组合,尤其用于回调、注册、装饰器等场景 - 它不解决“函数自身默认参数”的问题,而是绕过它——所以和前面的
None方案不冲突,可共存 - 注意
partial创建的新函数没有原函数的__defaults__,反射或文档生成工具可能识别不到默认值
Python 的可变默认参数陷阱本质是对象生命周期错配:你想每次调用都“新建”,但它却在定义时“只建一次”。只要守住 None 占位 + 运行时新建 这个模式,99% 的场景就稳了。真正容易被忽略的是类构造函数里的默认参数——那里一错,整个实例体系都跟着脏。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











