dir()返回的不是所有属性，而是对象当前命名空间中可枚举、非私有的名称列表，受__dir__方法控制，不保证完整性与顺序，且不验证属性是否真正可用。
dir() 返回的到底是不是“所有属性”
不是。它返回的是对象当前命名空间中**可枚举的、非私有（不以双下划线开头或结尾）的名称列表**，但这个列表受 __dir__ 方法控制，且不包含动态生成但未被显式注册的属性。
常见错误现象：dir(obj) 看不到你刚用 obj.new_attr = 42 动态赋值的属性？那基本不可能——除非该对象是用 __slots__ 限制了属性集，或者重写了 __dir__ 并故意过滤掉了它。
- 内置类型（如
list、str）的dir()结果包含大量继承自object的方法，比如__eq__、__repr__，但不包括像__dict__这类只在特定对象上存在的属性（例如实例有，类本身可能没有） - 如果类定义了
__dir__(self)，Python 会直接调用它，忽略默认逻辑。很多封装库（如 pandas 的 Series）就靠这个隐藏内部字段 -
dir()不保证顺序，也不保证完整性：C 扩展模块里用PyMethodDef注册的方法可能不会出现在dir()中，除非显式加入
为什么 dir(list) 和 dir([]) 输出不一样
因为一个是查 list 类本身，一个是查一个空 list 实例；它们的命名空间来源不同。
使用场景：调试时想确认某个方法是否属于实例还是类，或者怀疑自己调错了对象层级。
立即学习“Python免费学习笔记（深入）”；
-
dir(list)主要显示类属性、类方法（如fromkeys）、继承来的特殊方法（__subclasses__） -
dir([])显示实例能访问的所有名称，包括实例字典里的键（如果有）、继承链上的方法、以及由__dir__补充的内容 - 性能影响很小，但反复对大型对象（如含数千个键的 dict 实例）调用
dir()可能触发一次完整的属性扫描，不如直接查obj.__dict__.keys()（如果存在）来得快
如何判断某个名字是不是“真能用”的属性
dir() 只是列名字，不验证有效性。一个名字在 dir() 里出现，不代表你能安全读取或调用它。
容易踩的坑：看到 __weakref__ 就以为可以赋值，结果抛出 AttributeError: __weakref__ is not writable；或者看到 _private_method 就当成公有接口用，其实它是约定俗成的内部实现。
- 最可靠的方式是结合
hasattr(obj, 'name')+getattr(obj, 'name', None)，而不是只信dir() - 对方法，用
callable(getattr(obj, 'name', None))判断是否可调；对数据属性，注意有些是 property，读取可能触发异常（比如未初始化的 lazy 属性） - 某些框架（如 Django model 实例）的
dir()会包含大量字段名，但这些字段只有在模型实例已从数据库加载后才真正可读——否则会触发AttributeError或延迟查询
替代 dir() 的更精准方案
当你要找的是“我到底能对这个对象干啥”，dir() 是起点，不是终点。
常见错误现象：在 Jupyter 里敲 obj. + Tab，结果补全列表和 dir(obj) 不一致——这是因为 IPython 的补全逻辑额外检查了 __all__、__dir__，甚至动态运行了部分描述符。
- 查真实数据属性：
obj.__dict__.keys()（仅限有__dict__的实例） - 查类定义的属性（不含继承）：
[x for x in list.__dict__.keys() if not x.startswith('_')] - 查继承链上所有可调用方法：
[x for x in dir(obj) if callable(getattr(obj, x, None))] - 看文档字符串最直接：
help(obj.some_method)比猜dir()输出靠谱得多
真正复杂的地方在于：Python 的属性访问是分层的——描述符协议、__getattribute__、__getattr__ 共同作用的结果。dir() 只反映静态命名空间快照，而实际访问行为可能完全跑在另一套逻辑里。别把它当权威，只当线索。
