第 1 讲：Python 数据模型——特殊方法与协议设计

大家好，我是正在实战各种 AI 项目的程序员晚枫。

为什么同样的功能，别人写的代码更优雅？

答案：Python 数据模型。掌握它，让你的类像内置类型一样好用。

想象一下，你设计了一个向量类 Vector。你希望它能像数字一样相加、相乘，能打印出友好的字符串表示，能用 len() 获取维度。这些功能不是 Python 自动给你的，而是通过实现特殊方法（也叫魔术方法）来实现的。

🎯 什么是 Python 数据模型？

核心思想

Python 的数据模型是一套协议和约定，它定义了对象如何与 Python 的其他部分交互。通过实现特定的特殊方法，你的对象可以：

  • 像数字一样运算（+、-、*、/）
  • 像序列一样索引和切片（[]）
  • 像函数一样调用（()）
  • 像上下文管理器一样使用（with）
  • 像迭代器一样遍历（for）
1
2
3
4
5
6
7
# 普通写法
if len(my_list) > 0:
    first = my_list[0]

# Pythonic 写法
if my_list:  # 调用__bool__
    first = my_list[0]  # 调用__getitem__

特殊方法的命名

特殊方法都用双下划线开头和结尾，比如：

方法作用触发场景
init初始化创建对象时
repr官方字符串表示repr()、交互式解释器
str用户友好字符串str()、print()
len长度len()
getitem获取元素obj[key]
setitem设置元素obj[key] = value
add加法a + b
call调用obj()

🔑 关键协议

序列协议

实现序列协议，让你的对象像列表一样工作：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
class Deck:
    """一副扑克牌"""
    ranks = [str(n) for n in range(2, 11)] + list('JQKA')
    suits = '♠♥♦♣'
    
    def __init__(self):
        self._cards = [
            (rank, suit) for suit in self.suits
            for rank in self.ranks
        ]
    
    def __len__(self):
        return len(self._cards)
    
    def __getitem__(self, position):
        return self._cards[position]

# 使用
deck = Deck()
print(len(deck))      # 52
print(deck[0])        # ('2', '♠')
print(deck[:5])       # 切片支持
for card in deck:     # 迭代支持
    print(card)

只实现两个方法，Deck 就支持了：

  • len() 函数
  • 索引访问
  • 切片操作
  • for 循环遍历
  • in 运算符

数值协议

实现数值协议，让你的对象像数字一样运算：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = y
    
    def __repr__(self):
        return f'Vector({self.x}, {self.y})'
    
    def __add__(self, other):
        return Vector(self.x + other.x, self.y + other.y)
    
    def __mul__(self, scalar):
        return Vector(self.x * scalar, self.y * scalar)
    
    def __abs__(self):
        return (self.x ** 2 + self.y ** 2) ** 0.5

# 使用
v1 = Vector(3, 4)
v2 = Vector(1, 2)
print(v1 + v2)  # Vector(4, 6)
print(abs(v1))  # 5.0
print(v1 * 3)   # Vector(9, 12)

上下文管理协议

实现上下文管理协议，让你的对象支持 with 语句：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
class FileManager:
    def __init__(self, filename):
        self.filename = filename
    
    def __enter__(self):
        self.file = open(self.filename, 'r')
        return self.file
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        self.file.close()

# 使用
with FileManager('test.txt') as f:
    content = f.read()
# 自动关闭文件

💡 实战技巧

1. repr vs str

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age
    
    def __repr__(self):
        # 官方表示，用于调试
        return f"Person('{self.name}', {self.age})"
    
    def __str__(self):
        # 用户友好表示，用于打印
        return f"{self.name} ({self.age}岁)"

p = Person("张三", 30)
print(repr(p))  # Person('张三', 30)
print(str(p))   # 张三 (30 岁)
print(p)        # 张三 (30 岁) - print 调用__str__

2. 让类支持迭代

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
class MyRange:
    def __init__(self, start, end):
        self.start = start
        self.end = end
    
    def __iter__(self):
        self.current = self.start
        return self
    
    def __next__(self):
        if self.current >= self.end:
            raise StopIteration
        value = self.current
        self.current += 1
        return value

# 使用
for i in MyRange(1, 5):
    print(i)  # 1, 2, 3, 4

3. 鸭子类型

1
2
3
4
5
6
7
# 不关注类型，只关注行为
def print_length(obj):
    print(len(obj))  # 任何有__len__的对象都可以

print_length([1, 2, 3])      # 3
print_length("hello")        # 5
print_length({'a': 1, 'b': 2})  # 2

⚠️ 常见陷阱

1. 可变默认参数

1
2
3
4
5
6
7
8
9
# 错误示例
class BadExample:
    def __init__(self, items=[]):  # 危险！
        self.items = items

# 正确做法
class GoodExample:
    def __init__(self, items=None):
        self.items = items if items is not None else []

2. 忘记调用父类方法

1
2
3
4
5
6
7
8
9
10
11
# 错误示例
class Child(Parent):
    def __init__(self, value):
        self.value = value
        # 忘记调用 super().__init__()

# 正确做法
class Child(Parent):
    def __init__(self, value):
        super().__init__()
        self.value = value

🎯 本讲总结

通过本讲，我们理解了：

数据模型：Python 对象交互的协议和约定。

特殊方法：让自定义对象像内置类型一样工作。

关键协议：序列协议、数值协议、上下文管理协议等。

实战技巧：repr vs __str__、迭代器实现、鸭子类型。

常见陷阱：可变默认参数、忘记调用父类方法。

📚 推荐教材

《Python 编程从入门到实践（第 3 版）》 - Eric Matthes 著

Python 零基础入门首选。本书分为基础语法和项目实战两部分，适合完全没有编程经验的读者。

《流畅的 Python（第 2 版）》 - Luciano Ramalho 著

Python 进阶经典之作。深入讲解 Python 的高级特性，包括数据模型、函数式编程、面向对象、元编程等。

《CPython 设计与实现》 - Anthony Shaw 著

本书深入讲解 CPython 内部机制，从内存管理到字节码执行，从对象模型到并发编程。配合本课程学习，效果更佳。

学习路线建议：

1
零基础 → 《从入门到实践》 → 《流畅的 Python》 → 本门课程 → 《CPython 设计与实现》

🔗 课程导航

← 课程大纲 | 下一讲：数据容器深度解析 →

💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务：AI 编程培训、企业内训、技术咨询

进群

嗨，扫码 进群

微信

扫一扫，分享到微信

微信分享二维码
本站总访问量次

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置：

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

编程博主，全网粉丝30w+，开源项目：python-office，我的微信：python-office