用None做默认值更安全，因Python默认参数在定义时求值一次，可变对象作默认值会导致多次调用共享同一对象；None作哨兵可确保每次调用在函数体内创建新对象，避免状态污染。
类方法中用 None 做默认值为什么比直接写默认值更安全
因为 Python 函数的默认参数在定义时就求值一次，如果用可变对象（如 []、{}）作默认值，多次调用会共享同一份内存。用 None 占位，把实际初始化逻辑放到函数体内，能确保每次调用都拿到干净的新对象。
常见错误现象：def append_item(item, lst=[]): lst.append(item); return lst 连续调用会不断往同一个列表里塞元素。
- 正确写法是：
def append_item(item, lst=None): lst = lst or []或更严谨地lst = [] if lst is None else lst -
None是单例，适合做“未传参”的信号，不会和业务值冲突（比如你不会故意传None表示“我要一个空列表”） - 注意：如果业务本身允许
None作为合法输入（比如字段可为空），就得换哨兵对象，例如sentinel = object()
类方法里动态生成默认值要避开实例属性干扰
在 __init__ 或其他实例方法中，不能直接用 self.xxx 给参数设默认值——那不是默认值，是运行时取值，且容易引发 AttributeError（属性还没初始化）。
典型误用：def process(self, data=self.default_data) —— 这会在类定义时就执行，self 根本不存在。
立即学习“Python免费学习笔记（深入）”；
- 动态默认值必须写在函数体内部，例如：
data = data if data is not None else self._get_default_data() - 如果依赖实例状态（比如配置、缓存），确保
_get_default_data()是实例方法，且已初始化完成 - 避免在默认值逻辑里触发副作用（如发 HTTP 请求、读文件），否则每次不传参都会执行，影响性能和可测性
@staticmethod 和 @classmethod 中的默认值处理差异
静态方法没有 self 或 cls，没法访问实例或类状态，所以它的“动态默认值”只能依赖全局变量、环境变量或纯函数计算；类方法能用 cls 获取类属性或调用类方法，但要注意类属性可能被子类覆盖。
-
@staticmethod示例：def now(fmt=None): fmt = fmt or "%Y-%m-%d"—— 只能靠参数判断，无法感知当前类 -
@classmethod示例：def create(cls, config=None): config = config or cls.DEFAULT_CONFIG——cls.DEFAULT_CONFIG可被子类重定义 - 若类方法里调用
cls()构造实例，要确认子类是否重写了__init__，否则默认值逻辑可能失效
带类型提示时如何标注 None 占位的参数
用 Optional[T] 或 T | None（Python 3.10+）明确告诉类型检查器该参数可为 None，否则 mypy 会报错说 “None not allowed”。但注意：类型提示不影响运行时行为，仍需手动判空。
- 推荐写法：
def load_config(self, path: str | None = None) -> dict: - 如果默认值逻辑复杂（比如要 fallback 到多个来源），可在 docstring 里说明优先级，比如 “先查
path，再查环境变量CONFIG_PATH，最后用内置模板” - 别为了类型提示强行用
Union[str, None]而不用|—— 后者更简洁，且新版本工具链支持更好
最常被忽略的一点：动态默认值的计算结果最好具备幂等性。比如生成时间戳、随机数、UUID 这类每次都不一样的值，要确认业务是否真的需要“每次不同”，否则可能造成难以复现的 bug 或缓存击穿。
