当前位置：首页>python>从零开始学python-私有属性和私有方法

从零开始学python-私有属性和私有方法

2026-09-02 20:22:39

Hi～新朋友，记得点上面蓝字(网虫root)关注哟~

前言:

在面向对象编程中，封装是一个核心原则，它允许我们将数据和操作数据的方法绑定在一起，并隐藏内部实现细节，只暴露必要的接口。Python通过一些命名约定和名称修饰机制，提供了对私有属性和私有方法的支持。

一、私有属性的定义与访问

在Python中，并没有严格的“私有”关键字（如Java的private）。而是通过命名约定来实现：

单下划线前缀 _：表示“保护”成员，是一种约定，告知其他开发者这个属性或方法不应该在外部直接访问，但Python解释器并不阻止访问。
双下划线前缀 __：触发名称修饰（name mangling），使属性名在类定义内部被改写为 _类名__属性名，从而避免在继承中意外覆盖，也增加了外部直接访问的难度。

1. 使用双下划线定义私有属性

class MyClass:    def __init__(self):        self.public = "公开属性"        self._protected = "保护属性（约定）"        self.__private = "私有属性"obj = MyClass()print(obj.public)          # 正常输出：公开属性print(obj._protected)      # 可以访问，但按约定不应该直接访问# print(obj.__private)     # 直接访问会报错：AttributeError

输出：

公开属性保护属性（约定）

直接访问 __private 会引发 AttributeError，因为名称已经被改变了。我们可以通过 dir(obj) 查看对象的属性：

print(dir(obj))# 输出中会包含 '_MyClass__private' 这样的名称

2. 通过名称修饰后的名称访问私有属性

虽然双下划线属性不能直接通过原名访问，但Python并没有完全阻止我们——只是把名字改了。我们可以通过 _类名__私有属性名来访问：

print(obj._MyClass__private)   # 输出：私有属性

注意：这种访问方式极不推荐，它破坏了封装性，而且可能因版本变更导致代码失效。私有属性的目的是隐藏内部实现，外部代码应该通过公开的接口（方法）来操作它们。

二、私有方法的定义

私有方法的定义与私有属性类似，同样使用双下划线前缀：

class MyClass:    def public_method(self):        print("公开方法")        self.__private_method()   # 内部可以调用私有方法    def __private_method(self):        print("私有方法被调用")obj = MyClass()obj.public_method()   # 正常工作obj.__private_method()   # AttributeError

输出：

公开方法私有方法被调用

同样，私有方法也可以通过名称修饰后的名字在外部调用，但这是不推荐的。

三、名称修饰（Name Mangling）机制

当我们在类定义中写下以双下划线开头的属性名（例如 __foo）时，Python会自动将其名称改写为 _类名__foo。这个改写发生在类的定义阶段，目的是为了防止在子类中意外覆盖父类的同名属性。

例如：

class Parent:    def __init__(self):        self.__value = 100class Child(Parent):    def __init__(self):        super().__init__()        self.__value = 200   # 这实际上是 _Child__value，与父类的 _Parent__value 不同c = Child()print(dir(c))可以看到 _Parent__value 和 _Child__value 同时存在

这个机制使得父类的私有属性在子类中不会意外地被同名属性覆盖，保证了封装的安全。但是，名称修饰并不是为了让属性变得完全不可访问，而是为了避免命名冲突。

四、语法规范

语法形式	说明	示例
`__attribute`	私有属性（类内定义，外部通过名称修饰访问）	`self.__name = "John"`
`__method()`	私有方法（类内调用，外部无法直接调用）	`def __private_method(self):`
`_ClassName__attribute`	名称修饰后的形式（仅用于外部访问，不推荐在代码中直接使用）	`obj._MyClass__private`

⚠️ 重要提醒：

以两个下划线开头（如__var）是私有约定，不是以两个下划线结尾（如var__）
特殊方法（如__init__）不是私有属性，而是Python内置的魔法方法

五、单下划线的约定

单下划线前缀 _ 是Python社区广泛接受的约定，表示“虽然我可以被访问，但请把我当作内部实现，不要直接使用”。比如在模块中，_var 通常不会被 from module import * 导入。在类中，它表示保护成员，但没有任何语言层面的强制。

class MyClass:    def __init__(self):        self._internal = "内部数据"   # 约定为受保护    def _helper(self):               # 约定为内部辅助方法        pass

使用单下划线是一种礼貌的约定，告诉其他开发者：这个成员不是公开API的一部分，使用风险自负。

六、实际示例：

示例1：下面通过一个银行账户的例子，综合展示私有属性和私有方法的使用：

class BankAccount:    def __init__(self, owner, initial_balance):        self.owner = owner                # 公开属性        self.__balance = initial_balance  # 私有属性（余额）        self.__transaction_log = []       # 私有属性（交易记录）    def deposit(self, amount):        if amount > 0:            self.__balance += amount            self.__log_transaction(f"存入 {amount}")            print(f"成功存入 {amount}，当前余额：{self.__balance}")        else:            print("存款金额必须为正数")    def withdraw(self, amount):        if amount > 0 and self.__balance >= amount:            self.__balance -= amount            self.__log_transaction(f"取出 {amount}")            print(f"成功取出 {amount}，当前余额：{self.__balance}")        else:            print("余额不足或金额无效")    def get_balance(self):        """公开的获取余额的方法"""        return self.__balance    def __log_transaction(self, message):        """私有方法：记录交易"""        self.__transaction_log.append(message)    def show_transactions(self):        """公开方法：显示交易记录"""        for log in self.__transaction_log:            print(log)使用示例：account = BankAccount("张三", 1000)account.deposit(500)account.withdraw(200)print(f"当前余额：{account.get_balance()}")account.show_transactions()尝试直接访问私有属性：print(account.__balance)          # AttributeErrorprint(account._BankAccount__balance) # 可以但不应这样做

输出：

成功存入 500，当前余额：1500成功取出 200，当前余额：1300当前余额：1300存入 500取出 2001300

在这个例子中，__balance 和 __transaction_log 是私有属性，__log_transaction 是私有方法。外部只能通过公开方法 deposit、withdraw、get_balance 和 show_transactions 来操作账户，保证了余额和交易记录的安全性和一致性。

示例2：基础私有属性与方法

class BankAccount:    def __init__(self, owner, balance=0):        self.owner = owner  # 公共属性        self.__balance = balance  # 私有属性（名称修饰后为 _BankAccount__balance）    def deposit(self, amount):        if amount > 0:            self.__balance += amount  # 类内调用私有属性            return f"Deposited: {amount}, New Balance: {self.__balance}"        return "Invalid amount"    def get_balance(self):  # 通过公共方法访问私有属性        return self.__balance    def __private_method(self):  # 私有方法        return "This is a private method"创建对象：account = BankAccount("Alice", 100)✅ 正确：通过公共方法访问私有数据：print(account.get_balance())  # 输出: 100❌ 错误：直接访问私有属性（引发AttributeError）：try:    print(account.__balance)except AttributeError as e:    print(f"Error: {e}")  # 输出: Error: 'BankAccount' object has no attribute '__balance'✅ 正确：通过名称修饰访问（仅用于调试/特殊场景，不推荐在生产代码使用）：print(account._BankAccount__balance)  # 输出: 100❌ 错误：直接调用私有方法：try:    account.__private_method()except AttributeError as e:    print(f"Error: {e}")  # 输出: Error: 'BankAccount' object has no attribute '__private_method'✅ 正确：在类内部调用私有方法（通过公共方法间接调用）：print(account.deposit(50))  # 输出: Deposited: 50, New Balance: 150

输出结果：

100Error: 'BankAccount' object has no attribute '__balance'100Error: 'BankAccount' object has no attribute '__private_method'Deposited: 50, New Balance: 150

✅ 验证：

__balance 无法直接访问（AttributeError）
通过 _BankAccount__balance 可访问（名称修饰后）
__private_method 无法在外部调用
通过公共方法（如get_balance()）提供对私有数据的访问，而非暴露属性。

示例3：子类中访问父类私有属性

class Parent:    def __init__(self):        self.__private = 10  # 父类私有属性（修饰后为 _Parent__private）class Child(Parent):    def __init__(self):        super().__init__()        self.__private = 20  # 子类私有属性（修饰后为 _Child__private）    def access_parent_private(self):        # ❌ 错误：尝试直接访问父类私有属性（实际访问的是子类的私有属性）        return self.__private    def access_parent_private_correctly(self):        # ✅ 正确：通过名称修饰访问父类私有属性        return self._Parent__private创建对象：child = Child()❌ 错误：直接访问（返回子类私有属性）：print(child.access_parent_private())  # 输出: 20✅ 正确：通过父类名称修饰访问：print(child.access_parent_private_correctly())  # 输出: 10