装饰器可通过setattr向类动态添加方法，需确保函数首参数为self，类/静态方法须用classmethod/staticmethod包装，并检查重名以避免覆盖。
不能直接用装饰器“给类增加方法”，但可以通过装饰器修改类的 __dict__ 或动态绑定函数到类，效果上等价于“增加方法”。关键在于：必须把函数绑定为未绑定方法（unbound method）或使用 types.MethodType 绑定到实例——但更稳妥、更符合 Python 惯例的做法是直接将函数设为类属性，并确保第一个参数是 self。
装饰器必须接收类并返回修改后的类
Python 类装饰器本质是接收一个类对象、处理它、再返回（通常是原类或新类）。不能只操作局部作用域；必须显式赋值到类对象上。
- 错误写法：
@decorator里只定义函数但没挂到cls上 → 方法根本不会出现 - 正确路径：在装饰器内部执行
setattr(cls, 'method_name', func) - 注意：被添加的函数必须接受
self参数，否则调用时会报TypeError: missing 1 required positional argument: 'self' - 如果函数需要访问装饰器传入的参数（比如方法名、默认值），要用闭包包裹，而非直接引用外层变量
添加实例方法 vs 添加类方法/静态方法
装饰器加的方法默认是实例方法。若要加 @classmethod 或 @staticmethod，必须在 setattr 前显式包装：
- 加实例方法：直接
setattr(cls, 'foo', lambda self, x: ...) - 加类方法：用
setattr(cls, 'bar', classmethod(lambda cls, x: ...)) - 加静态方法：用
setattr(cls, 'baz', staticmethod(lambda x: ...)) - 混淆后果：不包装就直接赋值，调用
Class.bar()会因缺少cls参数而失败
避免覆盖已有属性和影响继承
直接 setattr 不检查是否重名，容易静默覆盖父类方法或数据属性。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 建议先用
hasattr(cls, name)判断，或加前缀（如_enhanced_）降低冲突概率 - 子类会继承这些动态添加的方法 —— 因为它们已写入父类
__dict__，这点和普通定义一致 - 但若装饰器在类定义后才运行（比如模块级装饰器延迟执行），而子类已导入，则子类可能看不到该方法（取决于执行时机）
- 调试时可用
vars(MyClass)或MyClass.__dict__.keys()确认方法是否真的写入成功
一个安全可复用的装饰器示例
下面这个装饰器支持批量添加多个方法，并自动处理实例/类/静态方法类型：
from functools import wraps
<p>def add_methods(**method_defs):
def decorator(cls):
for name, (func, method_type) in method_defs.items():
if method_type == 'class':
bound_func = classmethod(func)
elif method_type == 'static':
bound_func = staticmethod(func)
else:
bound_func = func
setattr(cls, name, bound_func)
return cls
return decorator</p><h1>使用</h1><p>@add_methods(
greet=(lambda self: f"Hi {self.name}", 'instance'),
get_count=(lambda cls: cls.count, 'class'),
is_valid=(lambda s: isinstance(s, str), 'static')
)
class Person:
count = 0
def <strong>init</strong>(self, name):
self.name = name
真正容易被忽略的是：动态添加的方法无法被 IDE 自动补全，也不出现在 help() 的原始文档中；如果依赖类型检查（如 mypy），还需额外提供 stub 或 typing.overload 声明 —— 这些不是语法错误，但会让协作和维护变重。
