深入理解Python dir()函数（小白也能掌握的Python内置函数详解）

什么是 dir() 函数？

dir() 是 Python 的一个内置函数，用于返回一个对象的所有属性和方法的列表（以字符串形式）。如果你不传入任何参数，它会返回当前作用域中的所有变量、函数和模块名称。

基本语法

dir() 的语法非常简单：

dir([object])  

• 不带参数：返回当前作用域中的名称列表。
• 实际使用示例

  1. 不传参数：查看当前命名空间

  # 在交互式环境中运行>>> dir()['__annotations__', '__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__']  

  2. 查看字符串对象的方法

  >>> s = "hello">>> dir(s)['__add__', '__class__', '__contains__', '__delattr__', '__dir__', '__doc__',  '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__',  '__gt__', '__hash__', '__init__', '__iter__', '__le__', '__len__',  '__lt__', '__mod__', '__mul__', '__ne__', '__new__', '__reduce__',  '__repr__', '__rmod__', '__rmul__', '__setattr__', '__sizeof__',  '__str__', '__subclasshook__', 'capitalize', 'casefold', 'center',  'count', 'encode', 'endswith', 'expandtabs', 'find', 'format',  'format_map', 'index', 'isalnum', 'isalpha', 'isascii', 'isdecimal',  'isdigit', 'isidentifier', 'islower', 'isnumeric', 'isprintable',  'isspace', 'istitle', 'isupper', 'join', 'ljust', 'lower', 'lstrip',  'maketrans', 'partition', 'replace', 'rfind', 'rindex', 'rjust',  'rpartition', 'rsplit', 'rstrip', 'split', 'splitlines', 'startswith',  'strip', 'swapcase', 'title', 'translate', 'upper', 'zfill']  

  可以看到，dir(s) 列出了字符串 s 所有可用的方法和特殊属性（以双下划线开头的），这正是 Python反射机制 的体现——程序在运行时可以“自省”其结构。

  3. 查看自定义类的属性

  class Person:    def __init__(self, name):        self.name = name        def greet(self):        return f"Hello, I'm {self.name}"p = Person("Alice")print(dir(p))  

  输出结果将包含 'greet' 和 'name' 等自定义属性，以及继承自 object 的默认方法。

  为什么 dir() 如此重要？

  对于初学者来说，dir() 是探索 Python 对象的“探照灯”。当你拿到一个陌生的对象（比如第三方库中的类实例），不知道它有哪些方法可用时，只需调用 dir(obj)，就能快速了解其能力。

  此外，在调试和开发过程中，dir() 也是检查对象状态、排查属性错误的利器。它体现了 Python 强大的反射机制，让代码具备自我检查的能力。

  小贴士

  • 使用 [attr for attr in dir(obj) if not attr.startswith('_')] 可以过滤掉私有和特殊方法，只看“有用”的公共属性。
  • dir() 返回的是列表，你可以用 sorted(dir(obj)) 获得排序后的结果，便于阅读。
  • 在 Jupyter Notebook 或 Python REPL 中，dir() 是探索 API 的必备工具。

  总结

  通过本文，你应该已经掌握了 Python dir函数 的基本用法和实际价值。无论你是刚入门的新手，还是有一定经验的开发者，dir() 都是你工具箱中不可或缺的一部分。记住，理解对象的结构是高效编程的第一步，而 dir() 正是通往这一步的桥梁。

  希望这篇教程能帮助你更好地利用 Python内置函数 和 Python对象属性 的强大功能，提升你的编程效率！