什么是 Python dir() 函数？它能做什么？
在学习 Python 的过程中，你可能遇到过这样的场景：想查看一个对象有哪些方法或属性，但又不知道从哪里下手。这时候，dir() 函数就像一个“万能探测仪”，能帮你快速扫描出对象的全部可用功能。
Python dir() 函数是内置函数之一，它的作用是返回一个对象的所有属性和方法名称的列表。无论你是想探索一个模块、类、实例，还是简单的数据类型，dir() 都能为你提供一份清晰的“功能清单”。
举个生活中的比喻：想象你拿到一个全新的智能音箱，不知道它能做些什么。这时候你不会去拆开它，而是直接问：“你能做什么？”——这其实就是 dir() 的工作方式。它不改变对象，只是告诉你“你有哪些能力”。
使用方法非常简单，只需传入一个对象作为参数：
print(dir(str))
执行后会输出一长串方法名，比如 upper、lower、split 等等，这些都是字符串可以调用的内置方法。
这个函数在调试、学习和探索代码时特别有用。尤其是在你刚接触某个库或框架时，dir() 能帮你快速发现隐藏的功能。
探索内置类型与模块中的可用功能
当你开始使用 Python 的内置类型时，dir() 就成了你的“功能说明书”。我们以列表（list）为例，来看看它有哪些可用方法：
print(dir(list))
输出结果中你会看到 append、extend、pop、sort 等常用方法，还有像 __len__、__iter__ 这样的特殊方法（双下划线开头的，称为“魔术方法”或“dunder 方法”）。
这些方法是 Python 语言底层定义的，它们让列表具备了增删改查的能力。
再来看模块级别的使用。比如你想了解 math 模块提供了哪些数学函数，可以这样操作：
import math
print(dir(math))
你会看到 sqrt（平方根）、sin（正弦）、pi（圆周率常量）等。这在学习新模块时非常实用——不用翻文档，直接用 dir() 快速浏览。
提示：
dir()不仅能查看模块，还能查看你自己定义的类或函数对象。这让你在开发过程中随时掌握“自己造的东西有哪些功能”。
探索自定义类的属性与方法
当你定义自己的类时，dir() 能帮你验证是否正确添加了属性和方法。下面是一个简单的类定义示例：
class Student:
school = "清华大学" # 类属性
def __init__(self, name, age):
self.name = name # 实例属性
self.age = age
def introduce(self):
return f"大家好，我是 {self.name}，今年 {self.age} 岁。"
xiaoming = Student("小明", 18)
print(dir(xiaoming))
运行结果会包含：
name、age（实例属性）introduce（实例方法）school（类属性，也能被实例访问）- 一些内置的魔法方法，如
__init__、__class__、__dict__等
这说明 dir() 不仅返回你自己定义的内容，还会自动包含 Python 为对象添加的默认属性和方法。
重要提醒：
dir()返回的是一个列表，所以你可以像操作普通列表一样进行筛选、排序或遍历：
filtered = [item for item in dir(xiaoming) if item.startswith('i')]
print(filtered)
这种能力在自动化分析对象结构时非常有用。
特殊方法与魔术方法的发现
在 Python 中，很多“神奇”的行为都是通过特殊方法实现的。比如 + 运算符之所以能用于字符串拼接，是因为字符串类中实现了 __add__ 方法。
这些以双下划线开头的方法被称为“魔术方法”或“dunder 方法”。它们不直接调用，但会在特定操作下被自动触发。
dir() 函数能帮你发现这些隐藏的“幕后英雄”。来看一个例子：
print(dir(int))
输出中你会看到：
__add__：支持+运算__mul__：支持*运算__len__：支持len()函数__str__：支持str()转换__eq__：支持==比较
这些方法让你可以自定义类的行为。比如，如果你想让两个对象相加时有特定逻辑，只需重写 __add__ 方法即可。
class Vector:
def __init__(self, x, y):
self.x = x
self.y = y
def __add__(self, other):
# 定义两个向量相加的逻辑
return Vector(self.x + other.x, self.y + other.y)
def __str__(self):
return f"Vector({self.x}, {self.y})"
v1 = Vector(1, 2)
v2 = Vector(3, 4)
result = v1 + v2
print(result) # 输出：Vector(4, 6)
这里的关键是：dir() 帮我们找到了 __add__ 这个方法名，从而知道如何实现自定义行为。
实际应用场景与最佳实践
dir() 并不只是理论工具，它在真实开发中有很多实用场景：
1. 调试未知对象结构
当你从第三方库导入一个对象，但不知道它有哪些方法时，dir() 是最快捷的探索方式：
import requests
response = requests.get("https://httpbin.org/get")
print(dir(response)) # 快速查看 response 对象支持哪些方法
你可以看到 json()、text、status_code 等属性，快速上手。
2. 检查命名冲突
当你定义变量或函数时，如果和内置方法重名，可能会导致意外错误。用 dir() 可以提前检查：
print(dir())
3. 与 help() 配合使用
dir() 告诉你“有什么”，而 help() 告诉你“怎么用”。两者结合使用，效率极高：
print(dir(str)) # 先看有哪些方法
help(str.upper) # 再查看具体用法
这种组合是 Python 开发者最常用的“双剑合璧”技巧。
常见误区与注意事项
虽然 dir() 很强大，但有几个关键点需要注意：
1. dir() 不包含所有可能的属性
dir() 返回的是对象的 __dict__ 和 __class__ 中的属性，但不包括继承自父类的某些动态属性。如果你需要更全面的信息，可以结合 vars() 和 type() 使用。
2. 双下划线方法可能被名字重整
Python 会对以双下划线开头但不以下划线结尾的方法进行“名字重整”（name mangling），比如 __private 会被变成 _ClassName__private。因此，在 dir() 中可能看不到原始名称。
class Test:
def __init__(self):
self.__private = "secret"
obj = Test()
print(dir(obj)) # 输出：['_Test__private', ...]
3. 不要过度依赖 dir()
dir() 输出内容可能过多，尤其是对复杂对象。建议结合 filter 或 sorted 使用，提升可读性：
public_methods = [m for m in dir(xiaoming) if not m.startswith('_')]
print(public_methods)
总结：掌握 Python dir() 函数，提升开发效率
Python dir() 函数 是每位 Python 开发者都应该熟练掌握的利器。它不仅帮助你探索内置类型和模块，还能揭示自定义类的结构，发现隐藏的魔术方法。
无论你是初学者，还是有经验的开发者，dir() 都能成为你代码调试和学习过程中的“秘密武器”。它让你不再盲目猜测对象的能力，而是通过直接观察，获得清晰、准确的信息。
记住：遇到不知道“能做什么”的对象时，别急着查文档，先试试 dir()。它可能比你想象的更快、更直接。
编程的本质，就是不断探索和发现。而 dir()，正是你探索之路的第一盏灯。