Python实现类私有方法调度表分发时触发NameError的原因及修复

报错根本原因 #

• 核心逻辑偏差：Python加载类定义时，会从上到下逐行执行类体中的所有代码，和普通代码块的执行规则完全一致，不存在类内方法可以被前方代码引用的“前向引用”支持。
• 你将__dispatch调度表定义在所有类方法的最顶部，当代码执行到字典初始化逻辑时，后方声明的__login、__logout等方法还未被创建并加入类的命名空间，字典中直接书写__login本质是引用一个不存在的变量，因此触发NameError。
• 你之前判断的“私有修饰符导致问题”是错觉：就算把所有双下划线私有方法改成公开方法，只要调度表的位置仍在方法定义之前，依然会报对应方法名未定义的错误。双下划线触发的名字改写（把__login改成_Snackmachine__login）只是类加载后期的自动处理规则，和引用未定义变量的报错没有关联。
• 你尝试的方法绑定逻辑没有生效，是因为调度表本身在初始化阶段就因为NameError没有成功创建，代码根本走不到后续的__get__绑定逻辑，自然会报同样的错误。

可行的修复方案 #

方案1：调整类内代码顺序 #

将调度表的定义移动到所有类方法的声明之后，确保执行到调度表初始化逻辑时，所有被引用的方法已经完成创建、加入类命名空间。示例代码片段：

class Snackmachine:
    # 先完成所有方法的定义
    def __init__(self):
        ...

    def __login(self):
        ...
    def __logout(self):
        ...
    # ... 其余所有方法的定义都按原逻辑放在此处
    
    # 所有方法定义完成后，再初始化调度表
    __dispatch = {
        'login': __login,
        'logout': __logout,
        'addAccount': __add_user,
        'deposit': __deposit,
        # ... 其余调度项与原逻辑一致
    }

    def __command_dispatch(self, command):
        try:
            # 调度表存储的是未绑定的类函数，需要手动绑定到当前实例
            handler = self.__dispatch[command].__get__(self, type(self))
            handler()
        except KeyError:
            _print_fail("## Unknown Command!")

方案2：调度表存储方法名字符串（更推荐） #

不需要调整类内代码的书写顺序，直接在调度表中存储对应方法的名字字符串，调用时通过getattr从当前实例上获取已绑定的方法。这种写法同时适配私有方法、公开方法的调用，不需要手动处理方法绑定逻辑。示例代码：

class Snackmachine:
    # 调度表写在类最开头也不会报错，因为存的是字符串
    __dispatch = {
        'login': '__login',
        'logout': '__logout',
        'addAccount': '__add_user',
        'deposit': '__deposit',
        'balance': '__balance',
        'products': '__print_products',
        'buy': '__buy_product',
        'exit': '__exit_program',
        'restock': '__restock',
        'addProduct': '__add_product'
    }

    # ... 其余方法定义保持原位置不变
    def __init__(self):
        ...

    def __login(self):
        ...
    # ... 其余所有方法的定义按原逻辑书写

    def __command_dispatch(self, command):
        try:
            # getattr会自动处理私有方法的名字改写，直接返回绑定到当前实例的方法
            handler = getattr(self, self.__dispatch[command])
            handler()
        except KeyError:
            _print_fail("## Unknown Command!")

• 这种写法不需要手动编写__get__绑定逻辑，因为getattr从实例上获取方法时会自动完成实例绑定
• 不需要为私有方法手动填写改写后的_Snackmachine__login全名，Python会自动匹配对应属性
• 代码书写更灵活，不受类内代码顺序的限制

内容的提问来源于stack exchange，提问作者DomeE__