### 使用 Python `inspect` 模块定位软件要素或组件 Python 的内置模块 `inspect` 提供了许多有用的函数来获取有关活动对象的信息，这些对象包括模块、类、方法、函数、回溯等。这使得开发者能够动态地分析程序结构，在调试和元编程场景中有广泛应用。 #### 获取当前调用栈信息 为了理解代码执行流并追踪错误发生的位置，可以通过 `inspect.stack()` 函数访问当前线程的调用堆栈： ```python import inspect def get_caller_info(): stack = inspect.stack() caller_frame = stack[1] # 上一层帧即为调用者 print(f"Caller function name: {caller_frame.function}") print(f"Caller file path: {caller_frame.filename}") print(f"Caller line number: {caller_frame.lineno}") get_caller_info() ``` 上述代码展示了如何打印出调用者的函数名、文件路径及其所在的行号[^1]。 #### 查看对象属性与成员 如果想要了解某个特定对象的所有公共属性和方法，可以使用 `dir()` 或更详细的 `inspect.getmembers()` 方法: ```python class MyClass: def __init__(self): self.public_var = "public" self._private_var = "_private" obj = MyClass() for member_name, value in inspect.getmembers(obj): if not member_name.startswith('_'): # 排除私有成员 print(member_name, ':', value) ``` 这段脚本仅显示了实例 `MyClass` 中不以单下划线开头的公有变量名称及对应值。 #### 动态加载模块内的所有类定义 有时可能需要遍历整个包内所有的类定义，这时可以用到 `inspect.getmembers()` 结合 `isclass()` 进行筛选： ```python from mypackage import somemodule classes = [ cls for _, cls in inspect.getmembers(somemodule, predicate=inspect.isclass) ] print(classes) ``` 这里假设有一个名为 `mypackage.somemodule` 的模块，该片段将会列出其中定义的所有类。 #### 获得函数签名 对于任何给定的可调用对象（如函数），都可以通过 `signature()` 来查看它的参数列表和其他细节： ```python def example_function(a, b=None, *args, **kwargs): pass sig = inspect.signature(example_function) for param in sig.parameters.values(): print(param.name, param.default, param.kind) ``` 此部分演示了怎样提取目标函数的具体参数配置情况，这对于文档生成工具尤其有用。