class MyClass:
    def __private_method(self):
        return "私有方法"
        
obj = MyClass()
# 直接访问会报错
# obj.__private_method()  # AttributeError

# 通过改写后的名称可以访问
obj._MyClass__private_method()  # 返回 "私有方法"

使用原则

1. 优先使用单下划线：除非确实需要避免命名冲突，否则优先使用单下划线约定
2. 避免外部访问私有方法：不要通过改写名称访问私有方法
3. 提供公有接口：为需要外部使用的功能提供清晰的公有方法
4. 文档说明：在文档中说明哪些方法是内部使用的
5. 单元测试：通过公有方法测试私有功能，或使用特殊方法访问

常见错误

• 过度使用双下划线导致代码难以理解和维护
• 通过改写名称访问其他类的私有方法
• 在子类中尝试覆盖父类私有方法
• 在模块级别使用私有方法（名称改写只发生在类中）

class BankAccount:
    def __init__(self, account_holder, initial_balance=0):
        self.account_holder = account_holder
        self.__balance = initial_balance  # 私有属性
    
    def deposit(self, amount):
        """存款公共接口"""
        self.__validate_amount(amount)
        self.__balance += amount
        self.__update_database()
        return self.__balance
    
    def withdraw(self, amount):
        """取款公共接口"""
        self.__validate_amount(amount)
        if amount > self.__balance:
            raise ValueError("余额不足")
        self.__balance -= amount
        self.__update_database()
        return self.__balance
    
    def __validate_amount(self, amount):
        """私有方法：验证金额有效性"""
        if amount <= 0:
            raise ValueError("金额必须大于零")
    
    def __update_database(self):
        """私有方法：模拟更新数据库"""
        print(f"更新数据库: {self.account_holder} 余额: {self.__balance}")

# 使用示例
account = BankAccount("张三", 1000)
account.deposit(500)  # 正常调用
account.withdraw(200) # 正常调用

# 以下操作会报错
# account.__validate_amount(100)  # AttributeError
# account.__balance = 2000       # 不会修改实际余额

示例说明

• __validate_amount 和 __update_database 是私有方法，仅供类内部使用
• deposit 和 withdraw 是公共API接口
• __balance 是私有属性，外部无法直接修改
• 所有数据操作都通过公共方法进行，确保数据一致性