Python 雙下劃線開頭的具體使用

更新時間：2026年02月12日 09:52:35 作者：自由生長2024

本文主要介紹了Python 雙下劃線開頭的具體使用,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

在 Python 中，以兩個下劃線開頭（如 __method）的方法或屬性，并不完全是“私有方法”（private method）——因為 Python 并沒有像 Java 或 C++ 那樣嚴格的訪問控制機制。但這種命名方式會觸發(fā)一種叫做 名稱改寫（name mangling）的機制，從而在一定程度上實現(xiàn)“私有性”。

1. 名稱改寫（Name Mangling）

當你在一個類中定義一個以雙下劃線開頭、且不以雙下劃線結尾的方法或屬性時，Python 解釋器會自動將其名稱改寫為：

_ClassName__original_name

例如：

class MyClass:
    def __init__(self):
        self.__private_var = 42

    def __private_method(self):
        return "This is private"

obj = MyClass()
# obj.__private_method()  # AttributeError!
print(obj._MyClass__private_method())  # 可以訪問，但不推薦

雖然你仍然可以通過 _ClassName__name 的方式訪問到這個“私有”成員，但這是一種約定+語言機制，目的是防止子類意外覆蓋父類的內部方法，也提示開發(fā)者“這是內部使用的，不要直接調用”。

2. 與單下劃線的區(qū)別

單下劃線開頭（如 _method）：只是約定表示“內部使用”，不會觸發(fā)名稱改寫，外部仍可訪問。
雙下劃線開頭（如 __method）：觸發(fā)名稱改寫，提供更強的封裝暗示。

3. 特殊方法（魔術方法）例外

注意：如果方法名前后都有兩個下劃線（如 __init__, __str__），這是 Python 的特殊方法（也叫魔術方法），不會被名稱改寫，也不表示私有，而是用于實現(xiàn)特定語言特性。

1. 類的特殊方法（魔術方法）

以雙下劃線開頭和結尾的方法，被稱為特殊方法或者魔術方法（Magic Methods）。這些方法由 Python 解釋器自動調用，我們可以通過重寫它們來實現(xiàn)特定的類行為。

示例：

class MyClass:
    def __init__(self, value):  # 實例初始化方法
        self.value = value
    
    def __str__(self):  # 定義實例的字符串表示
        return f"MyClass(value={self.value})"
    
    def __add__(self, other):  # 定義加法操作
        return MyClass(self.value + other.value)
    
    def __len__(self):  # 定義長度
        return len(str(self.value))

常用的魔術方法：

__init__：對象初始化
__str__ 和 __repr__：字符串表示
__len__：長度
__add__、__sub__、__mul__：算術運算符
__eq__、__lt__、__gt__：比較運算符
__iter__ 和 __next__：迭代器協(xié)議
__getitem__ 和 __setitem__：索引操作

4.與單下劃線的區(qū)別

單下劃線（_method）：這是一種約定，表示方法是受保護的（protected），不應該在類外部直接使用。不過 Python 并不會強制限制這種訪問。
雙下劃線（__method）：會通過名稱修飾機制，讓方法更難以被外部訪問，主要用于避免子類命名沖突。

示例對比：

class Parent:
    def _protected(self):  # 單下劃線
        return "受保護的方法"
    
    def __private(self):  # 雙下劃線
        return "私有的方法"

class Child(Parent):
    pass

c = Child()
print(c._protected())  # 可以正常調用
print(c._Parent__private())  # 可以訪問，但需要使用修飾后的名稱
print(c.__private())  # 報錯：AttributeError