深入理解Python __dir__方法（小白也能掌握的Python对象属性探索技巧）

基本用法示例

让我们通过几个简单的例子来看看 dir() 是如何工作的：

# 查看字符串对象的所有属性和方法s = "hello"print(dir(s))# 查看列表对象lst = [1, 2, 3]print(dir(lst))# 查看模块（例如 math）import mathprint(dir(math))

运行上述代码，你会看到大量以双下划线（如 __add__、__len__）开头的方法，这些是Python的内置方法；同时也会看到普通方法（如 append、upper 等）。

自定义 __dir__ 方法

你不仅可以使用默认的 __dir__，还可以在自己的类中重写它，以控制 dir() 返回的内容。这在开发库或框架时特别有用。

class Person:    def __init__(self, name, age):        self.name = name        self.age = age        def greet(self):        return f"Hello, I'm {self.name}"        def __dir__(self):        # 自定义返回的属性列表        return ['name', 'age', 'greet', '__class__', '__module__']p = Person("Alice", 30)print(dir(p))# 输出: ['name', 'age', 'greet', '__class__', '__module__']

注意：通常建议在自定义 __dir__ 时保留一些关键的内置属性（如 __class__），否则可能会影响调试工具或IDE的自动补全功能。

__dir__ 与 __dict__ 的区别

很多初学者会混淆 __dir__ 和 __dict__。它们的区别如下：

• obj.__dict__：只包含对象的实例属性（不包括方法、类属性或继承的属性）。
• dir(obj)：返回对象的所有可访问属性和方法，包括继承的、内置的、动态生成的等。

class Animal:    species = "Mammal"  # 类属性        def __init__(self, name):        self.name = name  # 实例属性        def speak(self):      # 方法        passa = Animal("Dog")print("__dict__:", a.__dict__)  # {'name': 'Dog'}print("dir():", dir(a))         # 包含 'name', 'species', 'speak', '__class__', ... 等

实际应用场景

掌握 Python反射机制 中的 __dir__ 方法，可以在以下场景大显身手：

• 调试未知对象：当你拿到一个第三方库的对象但不清楚它有哪些方法时，用 dir() 快速探索。
• 动态调用方法：结合 getattr()，可以根据属性名字符串动态调用方法。
• 开发交互式工具：如Jupyter Notebook、IPython等都依赖 dir() 提供自动补全功能。

总结

__dir__ 是Python中一个强大而灵活的内置方法，它让我们能够以编程方式探索对象的结构。无论是用于日常调试、学习新库，还是构建高级框架，理解并善用 Python __dir__方法 都能显著提升你的开发效率。

记住，Python对象属性 的探索不再神秘——只需一行 dir(obj)，世界尽在掌握！

关键词回顾：Python __dir__方法、Python对象属性、Python内置方法、Python反射机制