不可变对象的__new__是唯一创建入口,必须在实例化时定型数据;__init__无法修改核心属性,否则报错或静默失败。正确做法是将校验、标准化等逻辑全放在__new__中,并用super().__new__(cls, args)返回已初始化实例。

不可变对象的 __new__ 不能靠“赋值”绕过,必须在创建时就定型;否则后续 __init__ 里改属性会直接报 TypeError: object does not support item assignment(对 tuple/subclass)或静默失败(对自定义类但没锁属性)。
为什么 __new__ 是唯一入口
Python 中不可变类型(如 str、tuple、frozenset)的实例一旦生成,其内存布局和内容就不可更改。你无法在 __init__ 中修改 self 的核心数据——因为 self 此时已是只读对象。所以所有定制逻辑(比如校验、标准化、缓存)必须塞进 __new__,且必须返回一个已“填好”的实例。
-
__new__接收的是类本身(cls)和原始参数,负责分配内存并返回新实例 -
__init__只是“初始化”,对不可变对象而言,它要么什么也不做,要么只能设只读属性(如self._hash_cache),不能碰核心字段 - 如果重写了
__new__却忘了调用父类的__new__(如super().__new__(cls)),会得到None,引发后续 AttributeError
典型错误:在 __init__ 里试图“修正”值
比如想让 Point(x, y) 自动把负数转成绝对值,但写在 __init__ 里:
class Point(tuple):
def __init__(self, x, y):
# ❌ 错误:tuple 实例不可变,这里 self 已固定,赋值无效
# self[0] = abs(x) # TypeError
# self.x = abs(x) # 静默忽略(除非用了 __slots__ 或 __setattr__ 拦截)
pass
正确做法是把标准化逻辑全放在 __new__:
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。
class Point(tuple):
def __new__(cls, x, y):
# ✅ 在实例诞生前就决定内容
normalized = (abs(int(x)), abs(int(y)))
return super().__new__(cls, normalized)
- 注意:必须用
super().__new__(cls, ...),传入最终元组,而不是先super().__new__(cls)再赋值 - 如果参数校验失败(如坐标超出范围),直接 raise 异常,不要返回部分构造的实例
- 避免在
__new__中做耗时操作(如网络请求),因为每次实例化都执行
配合 __slots__ 和 __hash__ 确保真正不可变
仅靠继承 tuple 不够保险——用户仍可能动态加属性(除非禁用)。要彻底封死,需显式声明 __slots__ = () 并实现 __hash__:
class Point(tuple):
__slots__ = () # ❌ 不加这行,Point(1,2).z = 3 就能成功
<pre class="brush:python;toolbar:false;">def __new__(cls, x, y):
return super().__new__(cls, (abs(x), abs(y)))
def __hash__(self):
return hash(tuple(self))
-
__slots__ = ()表示不允许新增任何实例属性,连__dict__都不分配 -
__hash__必须实现,否则实例无法放入 set 或作 dict key(默认继承自tuple通常够用,但显式写出来更明确) - 若从
object继承而非tuple,则需手动管理底层存储(如用__slots__+__new__初始化),难度陡增
缓存已存在实例:用 __new__ 做轻量级单例池
对简单不可变对象(如颜色、状态码),可利用 __new__ 查表复用,避免重复构造:
_cache = {}
<p>class Color(str):
def <strong>new</strong>(cls, name):</p><h1>✅ 先查缓存,命中则直接返回,跳过构造</h1><pre class="brush:python;toolbar:false;"> if name in _cache:
return _cache[name]
# ✅ 标准化输入(大小写归一)
normalized = name.lower()
instance = super().__new__(cls, normalized)
_cache[name] = instance
return instance
- 缓存键建议用原始参数的规范形式(如
normalized),而非原始name,避免Color("RED")和Color("red")存两份 - 注意线程安全:生产环境若并发高,需加
threading.Lock或用functools.lru_cache替代手动字典 - 缓存不宜无限增长,必要时加 TTL 或 LRU 驱逐逻辑
最易被忽略的一点:__new__ 返回的必须是当前类或其子类的实例,且类型要严格匹配——返回 tuple(...) 而不是 super().__new__(cls, ...) 会导致类型丢失,isinstance(obj, YourClass) 为 False。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










