Python特殊方法(魔术方法)详解与实战

雨后青山
雨后青山
发布时间:2026-10-15| 6人浏览过
原创

本文详细解析Python中常用的特殊方法(魔术方法),包括__len__、__str__、__repr__、__iter__、__getitem__、__new__、__call__、上下文管理器及运算符重载。通过具体代码示例,展示如何自定义类行为,实现单例模式、迭代器协议及对象调用等功能,帮助开发者深入理解Python对象模型。

1、概述

在Python中,特殊方法(也称为魔术方法)由解释器自动调用,开发者无需直接调用它们,而是通过内置函数或语法触发。例如,实现特殊方法__len__()后,可以直接使用内置函数len()来获取长度;此外,部分特殊方法的调用是隐式的,如for i in x循环背后实际上调用了内置函数iter(x)。

下文将介绍一些常用的特殊方法及其具体实现方式,并通过构建一个类来演示这些概念。

2、常用特殊方法及实现

2.1 _len__()

该方法通常用于返回对象的数量,通过调用len()函数来触发。在实现__len__()时,内部也可以直接使用len()函数来获取结果。


class Zarten():
    def __init__(self, age):
        self.age = age
        self.brother = ['zarten_1', 'zarten_2']

    def __len__(self):
        return len(self.brother) #可直接使用len()
        # return self.age

z = Zarten(18)
print(len(z))

2.2 __str__()

此方法定义了对象的字符串表现形式,其功能与__repr__()基本一致,但两者存在细微差别:

  • __str__()主要用于面向终端用户,提供友好的显示信息;而__repr__()则主要面向开发者,用于调试、日志记录或交互式解释器中的对象展示。
  • 在命令行环境中,如果仅实现__str_()后,直接输入对象名称通常会显示对象的内存地址;而实现了__repr__()后,其行为与直接调用print(对象)的效果相同。
  • 如果同时实现了这两个方法,Python会优先调用__str_(),。因此,建议在类中至少实现__repr__()以确保良好的调试体验。


class Zarten():
    def __repr__(self):
        return 'my name is Zarten_1'

    def __str__(self):
        return 'my name is Zarten_2'

z = Zarten()
print(z)

2.3 __iter__()

该方法用于返回一个可迭代对象,通常与__next__()配合使用以支持迭代协议。

要判断一个对象是否属于可迭代对象,可以使用 from collections import Iterable进行类型检查。


from collections import Iterable

class Zarten():
    def __init__(self, brother_num):
        self.brother_num = brother_num
        self.count = 0

    def __iter__(self):
        return self

    def __next__(self):
        if self.count >= self.brother_num:
            raise StopIteration
        else:
            self.count += 1
            return 'zarten_' + str(self.count)


zarten = Zarten(5)
print('is iterable:', isinstance(zarten, Iterable)) #判断是否为可迭代对象
for i in zarten:
    print(i)

2.4 __getitem__()

此特殊方法用于返回数据,它可以替代__iter_()和__next__()方法,同时也支持对对象进行切片操作。


class Zarten():
    def __init__(self):
        self.brother = ['zarten_1','zarten_2','zarten_3','zarten_4','zarten_5',]

    def __getitem__(self, item):
        return self.brother[item]

zarten = Zarten()
print(zarten[2])
print(zarten[1:3])

for i in zarten:
    print(i)

2.5 __new__()

__new__()用于构造类的实例,其第一个参数是cls,在常规开发中较少直接使用。相比之下,__init__()用于初始化实例,因此__new__()的执行顺序早于__init___()。

如果__new__()没有返回实例,则不会创建任何对象,,__init___()也不会被执行;

如果__new__()返回了其他类的实例,那么__init___()将不会执行;

应用场景:可以利用__new___()来实现单例模式。


class Zarten():
    def __new__(cls, *args, **kwargs):
        print('__new__')
        return super().__new__(cls)

    def __init__(self, name, age):
        print('__init__')
        self.name = name
        self.age = age

    def __repr__(self):
        return 'name: %s  age:%d' % (self.name,self.age)

zarten = Zarten('zarten', 18)
print(zarten)

2.6 使用__new__()实现单例模式


class Zarten():
    _singleton = None

    def __new__(cls, *args, **kwargs):
        print('__new__')
        if not cls._singleton:
            cls._singleton = super().__new__(cls)
        return cls._singleton

    def __init__(self, name, age):
        print('__init__')
        self.name = name
        self.age = age

    def __repr__(self):
        return 'name: %s  age:%d' % (self.name,self.age)

zarten = Zarten('zarten', 18)
zarten_1 = Zarten('zarten_1', 19)
print(zarten)
print(zarten_1)
print(zarten_1 == zarten)



2.7 __call__()

实现该方法后,类的实例将变为可调用对象,可以像函数一样被调用。例如,自定义函数、内置函数以及类本身都是可调用对象,可以使用callable()来判断一个对象是否具备可调用性。


class Zarten():

    def __init__(self, name, age):
        self.name = name
        self.age = age

    def __call__(self):
        print('name:%s  age:%d' % (self.name, self.age))


z = Zarten('zarten', 18)
print(callable(z))
z()

2.8__enter__()

一个支持上下文管理的类必须实现:__enter_()和__exit__()这两个特殊方法,并通过with语句来调用它们。

在__enter__()返中返回对象,随后使用__exit__()来关闭或清理对象资源。


class Zarten():

    def __init__(self, file_name, method):
        self.file_obj = open(file_name, method)

    def __enter__(self):
        return self.file_obj

    def __exit__(self, exc_type, exc_val, exc_tb):
        self.file_obj.close()
        print('closed')


with Zarten('e:\\test.txt', 'r') as f:
    r = f.read()
    print(r)

2.9 __add__()

该方法用于重载加法运算符,以及__radd__()反向运算符的重载。

当执行加法操作时,Python首先会在“+”左侧的对象中查找__add__(),;若未找到,则会在“+”右侧的对象中查找__radd__()。


class Zarten():

    def __init__(self, age):
        self.age = age

    def __add__(self, other):
        return self.age + other

    def __radd__(self, other):
        return  self.age + other



z = Zarten(18)
print(z + 10)
print(20 + z)

2.10 __del__()

该方法在对象生命周期结束时被调用,功能类似于其他语言中的析构函数。


class Zarten():

    def __init__(self, age):
        self.age = age

    def __del__(self):
        print('__del__')


z = Zarten(18)

特殊(魔术)方法汇总一览表

到此这篇关于Python基础-特殊方法详解的文章就介绍到这了,更多相关Python基础-特殊方法内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。