Python 类中常用魔法属性详解与示例

Theo

发布时间：2026-10-13 | 6人浏览过

原创

本文详细介绍 Python 类中常见的魔法属性，包括 __doc__、__module__、__init__、__del__、__call__、__dict__、__str__ 以及索引相关的 __getitem__ 等。通过具体代码示例，解析各属性的触发条件与实际应用场景，帮助开发者深入理解 Python 面向对象编程的核心机制。

本文通过具体实例解析 Python 类中魔法属性的使用方法，供读者参考学习。

魔法属性概述

如同事物存在特殊行为，Python 的类也拥有一系列具有特定含义的特殊属性，以下逐一详解。

doc：类的描述信息

1. __doc__

该属性用于存储类的描述信息。


class Foo:
  """ 描述类信息，这是用于看片的神奇 """
  def func(self):
    pass
print(Foo.__doc__)
#输出：类的描述信息

module 与 class：模块与类标识

2. __module__ 和 __class__

__module__ 属性指示当前对象所属的模块名称；__class__ 属性则标识当前对象所属的类。

test.py 文件内容如下：

# -*- coding:utf-8 -*-


class Person(object):
  def __init__(self):
    self.name = 'laowang'

main.py 文件内容如下：


from test import Person
obj = Person()
print(obj.__module__) # 输出 test 即：输出模块
print(obj.__class__) # 输出 test.Person 即：输出类

init：初始化方法

3. __init__

这是类的初始化方法。当使用类名创建对象时，该方法会自动触发执行。


class Person:
  def __init__(self, name):
    self.name = name
    self.age = 18
obj = Person('laowang') # 自动执行类中的 __init__ 方法

del：对象释放

4. __del__

当对象在内存中被释放时，该方法会自动触发执行。

注意：通常无需手动定义此方法。Python 作为高级语言，内存的分配与释放由解释器自动管理。__del__ 方法仅在解释器进行垃圾回收时自动触发。


class Foo:
  def __del__(self):
    pass

call：对象调用

5. __call__

当在对象后添加括号进行调用时，该方法会被触发执行。

注意：__init__ 方法的触发源于对象的创建（即对象 = 类名()）；而 __call__ 方法的触发源于对已创建对象的调用（即对象() 或类()()）。


class Foo:
  def __init__(self):
    pass
  def __call__(self, *args, **kwargs):
    print('__call__')
obj = Foo() # 执行 __init__
obj() # 执行 __call__

dict：属性字典

6. __dict__

该属性返回类或对象中的所有属性字典。

需区分的是，实例属性归属于对象，而类属性和方法归属于类。具体表现如下：


class Province(object):
  country = 'China'
  def __init__(self, name, count):
    self.name = name
    self.count = count
  def func(self, *args, **kwargs):
    print('func')
# 获取类的属性，即：类属性、方法、
print(Province.__dict__)
# 输出：{'__dict__': <attribute '__dict__' of 'Province' objects>, '__module__': '__main__', 'country': 'China', '__doc__': None, '__weakref__': <attribute '__weakref__' of 'Province' objects>, 'func': <function Province.func at 0x101897950>, '__init__': <function Province.__init__ at 0x1018978c8>}
obj1 = Province('山东', 10000)
print(obj1.__dict__)
# 获取 对象obj1 的属性
# 输出：{'count': 10000, 'name': '山东'}
obj2 = Province('山西', 20000)
print(obj2.__dict__)
# 获取 对象obj1 的属性
# 输出：{'count': 20000, 'name': '山西'}

str：字符串表示

7. __str__

若在类中定义了 __str__ 方法，则在打印对象时，默认输出该方法返回的值。


class Foo:
  def __str__(self):
    return 'laowang'
obj = Foo()
print(obj)
# 输出：laowang

索引操作：getitem、setitem、delitem

8. __getitem__、__setitem__、__delitem__

这三个方法分别用于处理获取、设置和删除索引操作，类似于字典的行为。


# -*- coding:utf-8 -*-
class Foo(object):
  def __getitem__(self, key):
    print('__getitem__', key)
  def __setitem__(self, key, value):
    print('__setitem__', key, value)
  def __delitem__(self, key):
    print('__delitem__', key)
obj = Foo()
result = obj['k1']   # 自动触发执行 __getitem__
obj['k2'] = 'laowang'  # 自动触发执行 __setitem__
del obj['k1']      # 自动触发执行 __delitem__

分片操作：getslice、setslice、delslice

9. __getslice__、__setslice__、__delslice__

这三个方法用于处理分片操作，例如对列表进行切片时的行为。


# -*- coding:utf-8 -*-
class Foo(object):
  def __getslice__(self, i, j):
    print('__getslice__', i, j)
  def __setslice__(self, i, j, sequence):
    print('__setslice__', i, j)
  def __delslice__(self, i, j):
    print('__delslice__', i, j)
obj = Foo()
obj[-1:1]          # 自动触发执行 __getslice__
obj[0:1] = [11,22,33,44]  # 自动触发执行 __setslice__
del obj[0:2]        # 自动触发执行 __delslice__

如需了解更多 Python 相关内容，可查看本站专题：《Python 面向对象程序设计入门与进阶教程》、《Python 数据结构与算法教程》、《Python 函数使用技巧总结》、《Python 字符串操作技巧汇总》、《Python 编码操作技巧总结》及《Python 入门与进阶经典教程》。

希望本文所述内容能对大家的 Python 程序设计有所帮助。