Python使用dir函数实现快速定位模块详解

# 无参数时：返回当前作用域的名称列表
print(dir())  

# 有参数时：返回指定对象的属性/方法列表
print(dir(str))  # 查看str类的所有方法

import math

# 查看math模块的所有属性
print(dir(math))

# 仅打印公开方法（过滤掉__开头的私有属性）
public_methods = [attr for attr in dir(math) if not attr.startswith('__')]
print("公开方法:", public_methods)

class Car:
    def __init__(self, brand, color):
        self.brand = brand  # 公有属性
        self._color = color  # 保护属性（约定俗成，非强制）
        self.__mileage = 0  # 私有属性（名称重整）

    def start_engine(self):  # 公有方法
        print(f"{self.brand}引擎启动！")
    
    def _check_mileage(self):  # 保护方法
        return self.__mileage

# 实例化对象
my_car = Car("Tesla", "Red")

# 查看对象所有属性
print("对象属性:", dir(my_car))

print(my_car._Car__mileage)  # 直接访问私有属性（不推荐！）
# 输出: 0

# 获取所有方法（过滤掉属性）
methods = [attr for attr in dir(my_car) if callable(getattr(my_car, attr))]
print("方法列表:", methods)

methods = [attr for attr in dir(my_car) 
           if callable(getattr(my_car, attr)) 
           and not attr.startswith('_')]  # 过滤保护/私有方法
print("公开方法:", methods)
# 输出: ['start_engine']

print("vars输出:", vars(my_car))
# 输出: {'brand': 'Tesla', '_color': 'Red', '_Car__mileage': 0}

print("dir输出:", dir(my_car))
# 输出: ['_Car__mileage', '__class__', ... , 'brand', 'start_engine', '_check_mileage']

import random
print("random模块可用方法:", [m for m in dir(random) if 'shuffle' in m])
# 输出: ['shuffle']

import datetime
print("时区相关方法:", [m for m in dir(datetime) if 'tz' in m])
# 输出: ['timezone', 'tzinfo']

class Animal:
    def speak(self):
        print("Animal sound")

class Dog(Animal):
    def bark(self):
        print("Woof!")

print("Dog的dir:", dir(Dog))  # 仅显示Dog自己的属性
# 输出: ['__class__', ... , 'bark', ...]  # 未显示speak()

print("Dog实例的dir:", dir(Dog())) 
# 输出包含'speak'方法

class Counter:
    count = 0
    def __init__(self):
        Counter.count += 1

print("类属性:", [attr for attr in dir(Counter) if attr not in ['__class__', '__dict__']])
# 输出: ['__doc__', '__init__', 'count']

import os
print("os模块常用功能:", [m for m in dir(os) if m not in ['__', 'path', 'walk']])

# 选择一个方法查看文档
help(os.listdir)

def generate_module_docs(module_name):
    module = __import__(module_name)
    methods = [m for m in dir(module) if not m.startswith('_')]
    print(f"【{module_name}】可用方法: {methods}")

generate_module_docs("math")

class MyClass:
    def __dir__(self):
        return ['custom_attr', 'custom_method']

obj = MyClass()
print(dir(obj))  # 输出: ['custom_attr', 'custom_method']

class NoDict:
    __slots__ = ['x']  # 禁用__dict__，节省内存

obj = NoDict()
obj.x = 10
print(dir(obj))  # 输出: ['x']  # 无__dict__

import inspect
import math

# 获取math模块的函数签名
for name, obj in inspect.getmembers(math, inspect.isfunction):
    print(f"{name}: {inspect.signature(obj)}")