Python类初始化设置默认值方法

Python类初始化时设置默认值看似简单，实则暗藏关键细节：参数默认值必须在`__init__`中显式声明，且不可直接使用可变对象（如列表、字典）作为默认值，否则会导致所有实例意外共享同一对象；正确做法是用`None`占位并在方法体内动态赋值，从而确保每次实例化都获得独立、新鲜的默认值——无论是静态常量还是实时生成的时间戳、UUID，只有将“参数可省略”与“实例属性必存在”二者精准配合，才能真正实现健壮、安全、符合直觉的初始化逻辑。

__init__ 里给参数设默认值的写法

Python 类初始化时设置默认值，就是在 __init__ 方法的参数列表中直接写 = 后跟默认值。这和普通函数默认参数规则完全一致，不是特殊语法。

常见错误是误以为必须在类属性上赋值才算“设默认值”，其实只要参数有默认值，调用时省略该参数，它就会自动取这个值，self.xxx = xxx 只是后续把参数存为实例属性——这两步是分离的。

• def __init__(self, name="unknown", age=0): 是合法且最常用的方式
• 可变对象（如 []、{}）不能直接作默认值，否则所有实例共享同一对象；要用 None 占位再内部判断：def __init__(self, items=None): self.items = items if items is not None else []
• 默认值表达式在定义函数时求值一次，不是每次实例化时重新计算

为什么 self.name = name 不等于设默认值

很多人混淆“参数有默认值”和“实例属性有默认值”。self.name = name 只是把传进来的 name 赋给实例，如果 name 参数本身没默认值，而调用时又没传，就会报 TypeError: __init__() missing 1 required positional argument。

也就是说：参数默认值控制“能不能不传”，self.xxx = 控制“传进来后存哪”。两者缺一不可才能实现“初始化即有值”。

• 只写 self.name = "default" 但参数没默认值 → 调用 MyClass() 仍会报错
• 只写参数默认值但漏掉 self.name = name → 实例没有 .name 属性，访问时报 AttributeError
• 正确组合才是完整方案：def __init__(self, name="default"): self.name = name

带类型提示时怎么写默认值

加了 typing 提示后，默认值写法不变，但要注意 None 作为默认值时，类型需显式标注为 Optional 或联合类型。

例如：from typing import Optional，然后写 def __init__(self, tag: Optional[str] = None):。如果写成 tag: str = None，类型检查器（如 mypy）会报错，因为 None 不属于 str。

• 基础类型（int, str, bool）直接写默认值没问题：count: int = 1
• 可选参数优先用 Optional[T]，等价于 T | None（Python 3.10+）
• 自定义类类型也一样：def __init__(self, config: Config = Config()):，前提是 Config 有无参构造

初始化时动态计算默认值的替代方案

如果默认值需要每次实例化时重新生成（比如时间戳、随机 ID、唯一编号），不能靠参数默认值实现，因为默认值只在函数定义时计算一次。得在方法体内处理。

典型做法是用 None 占位，再在函数体中判断并生成：

import time
from uuid import uuid4

class LogEntry:
    def __init__(self, message: str, timestamp: float = None, id_: str = None):
        self.message = message
        self.timestamp = timestamp if timestamp is not None else time.time()
        self.id_ = id_ if id_ is not None else str(uuid4())

注意这里 timestamp 和 id_ 的默认值都是 None，不是实际值；真正生成逻辑放在赋值前，确保每次实例化都独立执行。

容易被忽略的是：这种模式下，用户如果显式传入 None，也会触发生成逻辑——如果你需要区分“用户真想传 None”和“用户没传”，就得换 sentinel 对象（比如 object()），但绝大多数场景用 None 就够了。

本篇关于《Python类初始化设置默认值方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！