Python命名约定：单下划线_与双下划线__的封装机制及继承陷阱
在Python开发中，下划线前缀不是装饰，而是有明确语义的命名约定。很多新手以为 __var 是“私有变量”，实际上它触发的是名称修饰（name mangling）。本文通过代码实例和继承场景，带你彻底搞懂单下划线_和双下划线__的区别，并给出项目中的使用建议。一、概念与类比
Python官方定义（PEP 8）：
- 单下划线前缀 _var：表示该标识符是“非公开API”或实现细节，仅是一个约定。
- 双下划线前缀 __var：触发名称修饰，Python解释器将其转换为 _ClassName__var。
类比：公开文件放桌面；内部文件放标有“内部使用”的文件夹但没有锁；机密文件放保险柜并改名，需要特殊途径才能找到。
二、代码演示
2.1 单下划线 _ ：建议性的私有
class BankAccount:
def __init__(self, account_number, balance):
self.account_number = account_number # 公开
self._balance = balance # 受保护，约定不应直接访问
def display_info(self):
return f"Account: {self.account_number}, Balance: ${self._balance}"
def _calculate_interest(self, rate):
return self._balance * rate
my_account = BankAccount("6217001234", 1000)
print(my_account.account_number) # 6217001234
print(my_account._balance) # 1000，技术上可访问，但违反约定
print(my_account._calculate_interest(0.03))# 30.0
技术要点：
- 单下划线没有特殊语法意义，纯粹是命名约定。
- dir() 可以看到这些属性：'_balance', '_calculate_interest'。
2.2 双下划线 __ ：名称修饰机制
class UserAccount:
def __init__(self, username, password):
self.username = username
self._email = None
self.__password = password # 触发名称修饰
def verify_password(self, input_password):
return self.__password == input_password
def __reset_password(self):
self.__password = "default_password"
return True
user = UserAccount("zhang_san", "abc123")
print(user.username) # zhang_san
try:
print(user.__password) # AttributeError
except AttributeError as e:
print(f"Error: {e}")
try:
user.__reset_password() # AttributeError
except AttributeError as e:
print(f"Error: {e}")
print(user._UserAccount__password) # abc123，绕过名称修饰
技术要点：
- 双下划线触发名称修饰，将 __attr 转换为 _ClassName__attr。
- 目的不是安全，而是避免子类中的命名冲突。
- dir() 会显示 '_UserAccount__password', '_UserAccount__reset_password'。
三、继承中的区别（关键点）
class Parent:
def __init__(self):
self._protected = "Protected variable from parent"
self.__private = "Private variable from parent"
def _protected_method(self):
return "Protected method from parent"
def __private_method(self):
return "Private method from parent"
class Child(Parent):
def __init__(self):
super().__init__()
self._protected = "Protected variable overridden by child"
self.__private = "Private variable of child (won't override parent's)"
def _protected_method(self):
return "Protected method overridden by child"
def __private_method(self):
return "Private method of child (won't override parent's)"
def test_access(self):
print(f"Child accessing _protected: {self._protected}")
print(f"Child calling _protected_method: {self._protected_method()}")
try:
print(f"Trying to access parent's __private: {self.__private}")
except AttributeError as e:
print(f"Child cannot directly access parent's private var: {e}")
child = Child()
child.test_access()
# 输出:
# Child accessing _protected: Protected variable overridden by child
# Child calling _protected_method: Protected method overridden by child
# Child cannot directly access parent's private var: 'Child' object has no attribute '_Child__private'
print(f"Accessing parent's private var via mangled name: {child._Parent__private}")
print(f"Accessing child's private var via mangled name: {child._Child__private}")
结论：单下划线成员可以被子类访问和覆盖；双下划线成员在父类和子类中分别被修饰为不同名称，不会意外覆盖。
四、使用指南
- 无前缀：公开API，稳定且文档支持的接口。
class Rectangle:
def __init__(self, width, height):
self.width = width
self.height = height
def area(self):
return self.width * self.height
- 单下划线 _ ：内部实现，子类可重用，但不建议外部直接使用。
class DataProcessor:
def __init__(self, data):
self.data = data
self._processed = False
def process(self):
result = self._preprocess()
self._processed = True
return result
def _preprocess(self):
return
- 双下划线 __ ：防止子类覆盖，真正的私有细节（但不要依赖做安全防护）。
class AuthenticationSystem:
def __init__(self, username, password):
self.username = username
self.__password_hash = self.__hash_password(password)
def verify(self, password):
hashed = self.__hash_password(password)
return hashed == self.__password_hash
def __hash_password(self, password):
import hashlib
return hashlib.sha256(password.encode()).hexdigest()
五、实际项目中的惯例
Django 框架的 QuerySet 类使用单下划线作为内部过滤实现，双下划线用于完全内部的查询准备方法，外部只暴露 filter() 等公开API。现代Python项目建议：
- 谨慎使用双下划线，单下划线通常足够。
- 提供完整的API文档。
- 使用类型注解与docstring。
- 好的接口设计比严格的访问控制更重要。
from typing import List, Optional
class Customer:
"""客户信息管理类"""
def __init__(self, name: str, email: str) -> None:
self.name = name
self.email = email
self._purchases: List = []
def add_purchase(self, item: str) -> None:
self._purchases.append(item)
def get_purchase_history(self) -> List:
return self._purchases.copy()
六、小结
- 单下划线_ ：纯约定，子类可覆盖，表示“内部实现”。
- 双下划线__ ：触发名称修饰，防止子类意外覆盖，但在当前类和子类中可以通过 _ClassName__attr 访问。
- 默认优先使用无前缀（公开API），内部实现用单下划线，只有在担心子类覆盖时才用双下划线。
理解这些命名约定，能让你写出更符合Python风格的代码，也更易读懂大型Python项目。
Re: Python命名约定：单下划线_与双下划线__的封装机制及继承陷阱
楼主总结得非常好，特别是继承中双下划线名称修饰导致子类无法覆盖父类同名属性的这个点，很多新手都会在这上面踩坑。实际项目里，我觉得单下划线加文档注释已经足够表达“内部实现，请勿直接使用”的意图，双下划线更适合用来防止子类意外重写基类的关键内部逻辑（比如一些框架的钩子方法）。另外补充一个小细节：Python 中还有前后各双下划线的 `__var__`（魔法方法），这种不会触发名称修饰，和楼主说的双下划线前缀是两回事。感谢分享，很实用的指南！Re: Python命名约定：单下划线_与双下划线__的封装机制及继承陷阱
很好的总结！单下划线与双下划线确实是Python封装机制中容易混淆的点。名称修饰其实不是为了安全，而是为了避免子类意外重写父类的“私有”属性，这点很多新手会误解。你在继承部分的对比演示非常清晰，尤其是 `Child` 类中 `__private` 不会覆盖父类同名属性，而是各自独立存在，这个例子很直观。 另外，我在实际项目中一般只用单下划线表示内部实现细节（遵循约定），除非明确需要防止子类重写，才会考虑使用双下划线触发名称修饰。但也要小心，过度使用双下划线可能让代码调试和理解变得复杂，特别是别人不了解名称修饰时。感谢楼主的详细解释！Re: Python命名约定：单下划线_与双下划线__的封装机制及继承陷阱
感谢楼主分享，讲得非常清楚。之前一直以为双下划线就是“私有”，看完才明白实际上是名称修饰，而且跟单下划线在继承里的表现差异这么大。特别是 `Child` 类里的 `__private` 和 `__private_method` 并不会覆盖父类的同名属性/方法，这个陷阱我之前完全没意识到。以后写类继承的时候得多留意了。楼主提到的“建议性私有”和“避免命名冲突”这两个用途总结得很到位，对实际编码很有指导意义。
页:
[1]