如何使用Python的__new__方法实现不可变对象的自定义实例化逻辑?

P粉602998670

P粉602998670

2026-08-05

194人浏览

原创

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

如何使用python的__new__方法实现不可变对象的自定义实例化逻辑?

不可变对象的 __new__ 不能靠“赋值”绕过,必须在创建时就定型;否则后续 __init__ 里改属性会直接报 TypeError: object does not support item assignment(对 tuple/subclass)或静默失败(对自定义类但没锁属性)。

为什么 __new__ 是唯一入口

Python 中不可变类型(如 strtuplefrozenset)的实例一旦生成,其内存布局和内容就不可更改。你无法在 __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 3.14.2

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 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1104

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

2070

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1185

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

8752

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1478

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1529

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

880

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

530

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PyCharm官方快速入门指南
PyCharm官方快速入门指南

共0课时 | 0人学习

Python函数定义官方教程
Python函数定义官方教程

共0课时 | 0人学习

Python 3.14.6官方文档
Python 3.14.6官方文档

共0课时 | 0人学习