Python函数的默认参数若为可变对象(如列表、字典、集合),会在定义时创建一次并复用,导致多次调用间状态累积;正确做法是用None作默认值并在函数内初始化。

Python函数的默认参数看似简单,实则暗藏陷阱——尤其是当默认值是可变对象(如列表、字典、集合)时,容易引发意料之外的行为。根本原因在于:默认参数在函数定义时只被创建一次,而非每次调用时重新初始化。
为什么列表作默认参数会“记住”上次的结果?
这是最典型的陷阱。例如:
def add_item(item, lst=[]):
lst.append(item)
return lst
连续调用:
print(add_item("a")) # ['a']
print(add_item("b")) # ['a', 'b'] ← 意外!
第二次调用时,lst 并非空列表,而是上一次调用后修改过的那个对象。
立即学习“Python免费学习笔记(深入)”;
解决方法:用 None 作为默认值,在函数体内显式初始化:
def add_item(item, lst=None):
if lst is None:
lst = []
lst.append(item)
return lst
字典、集合等可变对象同理
所有可变默认参数都会复用同一对象实例:
- 用
dict={}作默认值 → 多次调用共享同一个字典 - 用
set()=set()作默认值 → 集合内容会累积 - 甚至自定义类的实例(如
cache=MyCache())也会持续复用
统一原则:默认值只用于不可变对象(None、int、str、tuple 等),可变对象必须延迟到函数体中创建。
如何安全地使用带默认值的可变参数?
除了用 None 判空初始化,还有几种实用写法:
-
使用空元组 + 转换:
def func(items=()): items = list(items)—— 利用元组不可变,每次转成新列表 -
用类型注解+运行时检查(适合工具链支持场景):
def func(lst: Optional[List] = None) -
对默认值做浅拷贝(仅适用于已存在对象需复用结构):
lst = default_lst.copy()
注意:深拷贝(copy.deepcopy)开销大,一般不推荐用于默认参数逻辑。
调试与识别这类问题的小技巧
当函数行为随调用次数变化时,可快速验证是否陷入默认参数陷阱:
- 打印默认参数对象的
id():print(id(lst))—— 若多次调用输出相同ID,就是复用了同一对象 - 在函数开头加断点或日志,观察参数初始状态是否符合预期
- 静态检查工具(如
pylint)通常会警告W0102: Dangerous default value
养成习惯:只要默认值可能被修改,就不用可变对象直接赋值。










