Python 2.7：继承dict的AttributeDict类在VS Code调试器无法展开

我之前也碰到过类似的情况——自定义的字典子类功能正常，但在VS Code调试器里就是没法像普通dict那样展开查看键值对，只能看到repl()的提示，确实挺影响调试效率的。咱们来一步步拆解问题，找到解决方案。

问题原因分析 #

你的AttributeDict直接继承了dict，并且把__getattr__和__setattr__直接绑定到了dict.__getitem__和dict.__setitem__上。这种写法虽然实现了属性式访问字典键的功能，但也干扰了VS Code调试器（基于debugpy）的对象识别逻辑：

• 调试器在展示字典类型时，会尝试读取对象的内部键值结构，或者通过__dir__方法获取可展示的属性列表
• 但你的重写让所有属性访问都被映射到了字典的键上，包括调试器需要访问的一些特殊属性（比如__dict__、内部调试相关属性），导致调试器无法正确识别这是一个可展开的字典对象，只能退而显示repl()的结果

可行的解决方案 #

方案1：重写__dir__方法，暴露所有字典键 #

给AttributeDict添加__dir__方法，返回字典的所有键加上父类的属性列表，这样调试器就能获取到所有可展示的内容：

class AttributeDict(dict):
    __getattr__ = dict.__getitem__
    __setattr__ = dict.__setitem__
    
    def __init__(self, *args, **kvargs):
        super(AttributeDict, self).__init__(*args, **kvargs)
    
    def __dir__(self):
        # 返回字典的所有键 + 父类的属性列表
        return list(self.keys()) + super(AttributeDict, self).__dir__()

方案2：修改__getattr__和__setattr__，排除特殊属性 #

只对非特殊属性（不以__开头的属性）做字典键的映射，让调试器能正常访问特殊属性：

class AttributeDict(dict):
    def __getattr__(self, name):
        # 不对特殊属性做映射，交给父类处理
        if name.startswith('__'):
            return super(AttributeDict, self).__getattr__(name)
        return self[name]
    
    def __setattr__(self, name, value):
        if name.startswith('__'):
            super(AttributeDict, self).__setattr__(name, value)
        else:
            self[name] = value
    
    def __init__(self, *args, **kvargs):
        super(AttributeDict, self).__init__(*args, **kvargs)

方案3：改用collections.UserDict继承 #

UserDict是用组合方式实现的字典包装类，内部维护一个独立的data字典，不会和实例的__dict__产生冲突，调试器能完美识别：

from collections import UserDict

class AttributeDict(UserDict):
    def __getattr__(self, name):
        return self.data[name]
    
    def __setattr__(self, name, value):
        # 特殊处理data属性，避免递归调用
        if name == 'data':
            super(AttributeDict, self).__setattr__(name, value)
        else:
            self.data[name] = value

VS Code调试器的显示逻辑补充 #

VS Code的Python调试器（基于debugpy）决定如何展示变量的逻辑大概是这样的：

• 首先检查对象的类型，对于内置类型（比如dict、list）会有专门的渲染逻辑，直接展开显示内部结构
• 对于自定义对象，会调用__dir__方法获取属性列表，然后逐个获取属性值来展示
• 如果对象的方法重写导致调试器无法正常获取内部结构（比如你的AttributeDict把所有属性访问都映射到字典键），就会退回到显示repr()的结果，也就是你看到的repl()提示

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