Python默认参数陷阱：可变对象累积及None占位

脚本专家

上个月接手一个订单统计系统，需求是对商品打标签，未传入标签列表时自动新建空列表。我快速写出了类似这样的函数：

2. def add_tag(item, tags=[]):
3.     tags.append(item)
4.     return tags

复制代码

测试通过后部署上线。第二天运营反馈：为“电子产品”添加的三个标签，竟然出现在“包邮”商品的标签列表里。数据库查询后发现，大量商品的标签数据互相串扰。排查两天，罪魁祸首就是那个看起来无害的空列表默认参数。

问题复现：

2. def add_tag(item, tags=[]):
3.     tags.append(item)
4.     return tags
6. print(add_tag("电子产品"))  # ['电子产品']
7. print(add_tag("包邮"))      # ['电子产品', '包邮']  ← 异常
8. print(add_tag("今日特价"))  # ['电子产品', '包邮', '今日特价']

复制代码

第二次调用时，“电子产品”依然留在列表中，因为默认参数列表在整个函数生命周期内是同一个对象。验证内存地址：

2. def add_tag(item, tags=[]):
3.     print(f"tags内存地址: {id(tags)}")
4.     tags.append(item)
5.     return tags

复制代码

两次调用输出的id相同，证明是同一个列表。

Python的默认参数在函数定义时创建，而非调用时创建。这是有意为之的设计：提升性能，避免每次调用都重新创建复杂对象；同时支持一些状态缓存的场景（如斐波那契缓存）。但这一特性对可变对象（列表、字典、集合、自定义类实例）来说是个陷阱，因为函数内部的修改会累积到同一个默认对象上，导致数据污染。不可变对象（字符串、整数、元组等）不会出现此问题。

常见危害场景：
1. Web API参数累积——默认字典导致timestamp重复添加。
2. 类实例共享列表——多个订单实例持有同一个默认列表。
3. 数据验证错误累积——连续调用的错误列表混淆。

标准解法：使用None作为占位符，在函数内部重新创建可变对象。

2. def add_tag(item, tags=None):
3.     if tags is None:
4.         tags = []
5.     tags.append(item)
6.     return tags

复制代码

每次调用都会新建列表，互不干扰。同样的模式适用于字典、集合和自定义类：

2. def f(x=None):
3.     if x is None:
4.         x = {}    # 或 set(), MyClass()
5.     ...

复制代码

如果使用类型注解，推荐写法：

2. from typing import Optional, List
4. def add_tag(item: str, tags: Optional[List[str]] = None) -> List[str]:
5.     if tags is None:
6.         tags = []
7.     tags.append(item)
8.     return tags

复制代码

Python 3.10+可简化为：

2. def add_tag(item: str, tags: list[str] | None = None) -> list[str]:
3.     if tags is None:
4.         tags = []
5.     tags.append(item)
6.     return tags

复制代码

类初始化时的正确写法：

2. class Order:
3.     def __init__(self, items: list | None = None):
4.         if items is None:
5.             items = []
6.         self.items = items

复制代码

总结：可变对象做默认参数时，务必用None占位，并在函数体内重建。现代工具如Pylint（W0102）、Flake8插件、Pyright/mypy均可检测此类危险默认值。在VSCode + Pylance中，默认就会给出警告。遵循此规则，可以避免一类非常隐蔽的Python陷阱。

热心网友6

感谢分享！这个陷阱确实是新手最容易踩的坑之一，你解释得非常清楚——尤其是用内存地址验证和实际案例来说明，让人印象深刻。我刚开始写 Python 时也在这个问题上翻过车，后来养成了一律用 `None` 占位 + 内部重建的习惯。你提到的类型注解写法也很实用，配合静态检查工具能提前拦截很多隐患。收藏了，下次在代码评审里可以直接引用你的总结。

热心网友6

感谢楼主这么详细地分享这个经典陷阱！之前我写一个小工具时也踩过类似的坑，函数内部用了默认空列表，结果不同用户的数据混在一起找了半天才反应过来。后来养成习惯，只要默认参数是可变对象就先用 None 占位，pyright 的警告也能帮上忙。楼主对类初始化和类型注解的写法总结得很清楚，收藏了～

热心网友6

这种坑踩过的人都懂，我第一次遇到时排查了一下午才意识到是默认参数的问题。楼主解释得很清楚，尤其是用id()验证内存地址那步，能直观看到是同一个对象。其实就算知道这个规则，写代码时也容易忘记，所以我现在写函数签名时都会下意识用`None`占位，然后类型注解里写`list | None`。Pylance确实会给出警告，但有时候写快速原型时容易忽略，还是养成习惯最重要。感谢分享现代Python的解法和工具建议。