Какая роль у методов, имён атрибутов и переменных, начинающихся с двух подчёркиваний?

Question

Имена, начинающиеся с двух подчёркиваний и не заканчивающиеся двумя подчёркиваниями (__name) в классах, подвергаются механизму name mangling: интерпретатор переписывает имя в _ClassName__name. Это помогает избежать конфликтов имён в иерархии наследования и служит более сильной формой инкапсуляции, чем одинарный _. Доступ к таким атрибутам возможен, но их труднее случайно переопределить или использовать. Отдельно есть "магические" методы с двойными подчёркиваниями по обе стороны (__init__, __len__), которые не мэнглятся и используются самим Python для реализации протоколов и операторов.

YeaHub · Accepted Answer

1. Два подчёркивания и name manglingОпределение:__name в теле класса — это имя, к которому применяется name mangling: интерпретатор переписывает его в _ClassName__name для уменьшения вероятности конфликтов и прямого доступа.Цель — усилить инкапсуляцию и защиту от случайного использования, особенно при наследовании.1.1. Как работает name manglingКогда вы объявляете атрибут класса __secret, Python внутри класса заменяет его имя:В классе User: __password → _User__passwordВ классе Admin: __password → _Admin__passwordPythonclass User:
    def __init__(self, password: str):
        self.__password = password  # станет self._User__password

def check_password(self, value: str) -> bool:
        return self.__password == value

u = User("1234")
# print(u.__password)  # AttributeError
print(u._User__password)  # технически работает, но так делать не стоит
Таким образом:Имя нельзя случайно переопределить в наследнике с тем же __name.Внешний код не увидит очевидного атрибута __password при обычном использовании.1.2. Отличия одинарного и двойного подчёркивания_name:Только соглашение.Легко доступен снаружи без всяких трюков.Не изменяется интерпретатором.__name:Подвергается name mangling → _ClassName__name.Используется для "почти приватных" атрибутов и избежания конфликтов.Всё еще доступен, но требуется знать "переписанное" имя.Реальная "защита" условная: опытный разработчик всегда сможет прочитать и изменить эти поля, но для случайного использования это серьёзный барьер.1.3. "Магические" методы: __init__, __len__ и другиеОтдельная категория — имена с двумя подчёркиваниями с двух сторон, например:__init____str____len____call____enter__, __exit__Определение:"Магические методы" (dunder methods) — это специальные методы, которые Python вызывает автоматически для реализации операторов, протоколов и поведения объектов.Важно:Они не подвергаются name mangling.Они фиксированы и описаны в документации языка.Нельзя произвольно придумывать свои __something__ и ожидать, что Python будет их как-то магически вызывать.Pythonclass User:
    def __init__(self, name: str):
        self.name = name

def __str__(self) -> str:
        return f"User({self.name})"

u = User("Alice")
print(u)  # автоматически вызовется u.__str__()
1.4. Когда использовать двойное подчёркиваниеИмеет смысл использовать __name когда:Вы проектируете класс, который будет расширяться и наследоваться другими разработчиками.Вам нужно спрятать внутренний атрибут, чтобы его случайно не переопределили в наследнике.Вы хотите показать, что это критичная внутренняя деталь реализации и её не следует трогать.Пример:Pythonclass BankAccount:
    def __init__(self, initial: int):
        self.__balance = initial  # сильная инкапсуляция

def deposit(self, amount: int) -> None:
        self.__balance += amount

def get_balance(self) -> int:
        return self.__balance
В отличие от _balance, атрибут __balance труднее случайно переопределить в наследниках.Краткий выводДвойное подчёркивание в начале имени запускает механизм name mangling и делает атрибут "почти приватным", защищая его от случайных конфликтов и использования. Магические методы с __name__ формируют стандартные протоколы языка. В обычной практике чаще достаточно одинарного _, а __name полезен в сложных и расширяемых классах.