链式调用必须返回 self，否则后续方法调用会因 NoneType 报 AttributeError；所有中间方法须显式 return self，校验失败应抛异常而非“假装成功”返回 self。
为什么链式调用必须返回 self
链式调用本质是连续调用对象方法，每次调用后要能继续点出下一个方法。如果方法返回 None（Python 默认返回值），下一次调用就会报 AttributeError: 'NoneType' object has no attribute 'xxx'。只有显式返回 self，才能让调用链条不断开。
常见错误现象：obj.set_name('a').set_age(25) 报错，但单独调用 obj.set_name('a') 没问题——说明前一个方法没返回实例。
- 所有参与链式调用的方法都必须以
return self结尾 - 不能在中间方法里提前
return其他值（比如return True或return self._data） - 若某个方法本意就是“终结操作”（如
save()、build()），可考虑返回其他值，但该方法就不能再接后续链式调用
如何避免属性赋值与链式逻辑耦合出错
很多初学者把链式写成“设完就返”，却忽略了参数校验失败时仍返回 self，导致对象处于非法状态还继续调用。这比不链式更危险。
正确做法是：校验失败时，要么抛异常中断链，要么静默处理但保持状态一致。不要“假装成功”返回 self。
- 推荐在校验失败时 raise
ValueError，例如if not isinstance(age, int): raise ValueError("age must be int") - 避免用
return self掩盖错误，比如if age —— 这会让obj.set_age(-5).set_name('x')看似成功，实则 age 未更新 - 如果业务允许忽略非法输入，应明确重置或跳过，并加注释说明行为，而非默认返回
self
__init__ 和链式构造器怎么配合
想支持 Person().set_name('A').set_age(30)，没问题；但如果还想支持 Person(name='A', age=30)，就得小心初始化逻辑重复或冲突。
典型坑：在 __init__ 里直接调用 self.set_name(name)，而 set_name 又做了非幂等操作（比如日志、事件触发），会导致初始化时多执行一次副作用。
- 初始化参数建议直接赋值（
self._name = name），不走 setter 方法 - 若需复用校验逻辑，可提取为私有方法（如
_validate_name(name)），在__init__和set_name中分别调用 - 避免在
__init__中调用可能被子类重写的 public 方法，以防 MRO 意外或尚未完成初始化
链式调用对继承和类型提示的影响
子类继承链式类后，父类方法返回 self 的类型仍是父类，IDE 和类型检查器（如 mypy）会认为后续调用只能使用父类方法，无法识别子类新增方法。
例如：子类 Student 继承 Person 并添加了 set_grade()，但 student.set_name('x').set_grade(95) 在 mypy 下会报错。
- Python 3.11+ 可用
Self类型（来自typing）：在方法签名中写def set_name(self) -> Self: - 旧版本可用
from typing import TYPE_CHECKING+ 字符串前向引用，或直接注释# type: () -> Person（不推荐） - 注意：即使类型提示修复了，运行时仍靠
return self，类型提示只是辅助，不改变行为
链式调用本身很简单，难的是在扩展性、错误处理、类型安全和继承场景下保持行为一致。最容易被忽略的是：校验失败时的返回策略，和子类中 self 类型的实际含义。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
