1. 不带参数调用

当不带参数调用时，dir()返回当前作用域中的名称列表：

# 不带参数调用
>>> dir()
['__annotations__', '__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__']

2. 带对象参数调用

当传递对象作为参数时，dir()返回该对象的所有属性和方法：

# 使用字符串对象
>>> my_str = "Hello Python"
>>> dir(my_str)
['__add__', '__class__', '__contains__', ... 'upper', 'zfill']

示例1：探索列表对象

# 创建列表对象
my_list = [1, 2, 3]

# 使用dir()查看列表的方法和属性
print(dir(my_list))

# 输出将包含：
# ['__add__', '__class__', '__contains__', ... 'append', 'clear', 'copy', 'count', 
# 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort']

示例2：检查自定义类

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age
        
    def greet(self):
        return f"Hello, my name is {self.name}"

# 创建Person实例
p = Person("Alice", 30)

# 使用dir()查看实例的属性和方法
print(dir(p))

# 输出将包含：
# ['__class__', '__delattr__', '__dict__', ... 'age', 'greet', 'name']

示例3：探索模块内容

import math

# 查看math模块的内容
print(dir(math))

# 输出将包含：
# ['__doc__', '__loader__', '__name__', ... 'sqrt', 'tan', 'tau', 'trunc']

过滤结果

使用列表推导式过滤结果，仅显示你感兴趣的内容：

# 只显示字符串方法（不显示双下划线方法）
s = "Hello"
methods = [m for m in dir(s) if not m.startswith('__')]
print(methods)

# 输出：
# ['capitalize', 'casefold', 'center', 'count', 'encode', 'endswith', 
# 'expandtabs', 'find', 'format', ... 'upper', 'zfill']

结合help()函数

使用dir()找到方法后，使用help()了解具体用法：

# 找到字符串的split方法
>>> help(str.split)

Help on method_descriptor:
split(...)
    S.split(sep=None, maxsplit=-1) -> list of strings
    
    Return a list of the words in S, using sep as the delimiter string...

方法	描述	返回类型
dir()	返回对象的有效属性列表	字符串列表
vars()	返回对象的__dict__属性	字典
__dict__	对象的属性字典	字典