xx 和 __xx__ 的核心区别

一、一句话结论

核心区别：
👉xx是写给业务用的
👉__xx__是写给 Python 解释器用的

二、xx—— 普通属性（Normal Attributes）

1️⃣ 是什么

classUser:def__init__(self,name):self.name=name# 普通属性self.age=18# 普通属性

• 完全由开发者控制
• 没有任何特殊含义
• 不影响 Python 的对象行为

2️⃣ 能做什么

user=User("Alice")user.name# 读user.name="Bob"# 写user.email="a@b.com"# 动态新增

✅用途：存数据、状态、配置

三、__xx__—— 魔法方法 / 特殊属性（Magic Methods）

1️⃣ 是什么

classUser:def__init__(self,name):self.name=namedef__str__(self):returnf"User({self.name})"def__len__(self):returnlen(self.name)

这些是Python 数据模型的官方接口，也叫dunder methods（double underscore）。

2️⃣ 为什么叫“魔法”

因为它们会被Python 解释器自动调用：

user=User("Alice")print(user)# 自动调用 user.__str__()len(user)# 自动调用 user.__len__()

没有显式调用，但它们被执行了。

四、最常见的__xx__分类速查

🔧 对象生命周期

classDemo:def__init__(self):print("对象创建了")def__del__(self):print("对象销毁了")

🖨️ 字符串表示

classUser:def__init__(self,name):self.name=namedef__str__(self):returnf"👤{self.name}"def__repr__(self):returnf"User(name={self.name!r})"u=User("Alice")print(u)# 👤 Aliceprint(repr(u))# User(name='Alice')

✅黄金法则：__repr__应该是无歧义的，__str__应该是可读的

🧮 运算符重载

classMoney:def__init__(self,amount):self.amount=amountdef__add__(self,other):returnMoney(self.amount+other.amount)def__eq__(self,other):returnself.amount==other.amount m1=Money(10)m2=Money(20)m3=m1+m2print(m3.amount)# 30

📦 容器行为

classMyList:def__init__(self,items):self.items=itemsdef__len__(self):returnlen(self.items)def__getitem__(self,index):returnself.items[index]ml=MyList([1,2,3])print(len(ml))# 3print(ml[1])# 2

🎯 可调用对象

classAdder:def__call__(self,a,b):returna+b add=Adder()print(add(1,2))# 3 ← 对象像函数一样被调用

五、⚠️ 最重要的一条规则

__xx__只能实现 Python 已有的协议，不要自己发明

❌ 错误示范：

classUser:def__my_custom__method__(self):# ❌ 这是灾难pass

✅ 正确做法：

classUser:defmy_custom_method(self):# ✅ 普通方法pass

原因：

• Python 未来版本可能会占用这个名字
• 破坏代码的可读性和一致性
• 其他开发者会困惑

六、和__xx（双下划线无后缀）的区别

classDemo:normal=1__mangled=2# 变成 _Demo__mangleddef__init__(self):pass# 魔法方法def__len__(self):return0# 魔法方法

七、内置特殊属性一览

obj.__class__# 对象的类obj.__dict__# 实例属性字典obj.__module__# 所在模块cls.__bases__# 父类元组cls.__mro__# 方法解析顺序func.__name__# 函数名func.__doc__# 文档字符串

八、实战判断口诀

🔍看到__xx__就问自己：

• 这是 Python 官方定义的吗？
• 它会在什么场景下被自动调用？
• 我是不是在实现一个协议？

🔍看到xx就问自己：

• 这是业务数据吗？
• 需不需要控制访问？（→ property）
• 是不是内部实现？（→_xx）

九、总结对照表

十、一句话终极总结

xx是给代码用的，__xx__是给 Python 用的。
前者你说了算，后者 Python 说了算。