如何获取Python文件导入模块/对象的定义文件路径？

以下是几个贴合需求的轻量方案，无需修改项目文件，可精准获取Python文件的直接依赖路径：

1. 基于importlib标准库的精准解析 #

利用Python原生importlib模拟导入流程，无需执行业务代码即可定位模块/对象的源文件路径，能覆盖绝大多数导入场景：

import importlib
import inspect
import sys
from pathlib import Path

def get_dependency_file(target_file, module_name, obj_name=None):
    # 将项目根目录加入sys.path（假设target_file在项目内）
    project_root = Path(target_file).parent
    sys.path.insert(0, str(project_root))
    
    # 定位模块路径
    spec = importlib.util.find_spec(module_name)
    if not spec or not spec.origin:
        return None
    module_path = spec.origin
    
    # 如果需要定位特定对象的文件
    if obj_name:
        # 加载模块但避免重复导入
        if module_name not in sys.modules:
            module = importlib.util.module_from_spec(spec)
            sys.modules[module_name] = module
            try:
                spec.loader.exec_module(module)
            except Exception:
                # 忽略导入执行错误，仅处理已加载的对象
                pass
        # 获取对象源文件
        obj = getattr(sys.modules[module_name], obj_name, None)
        if obj:
            return inspect.getsourcefile(obj)
    return module_path

优势：完全依赖标准库，无需额外安装；支持绝对导入、相对导入、命名空间包等场景；能定位到具体对象的定义文件。

2. 静态解析：ast+路径匹配 #

结合你已有的tree-sitter导入解析结果，用Pythonast模块配合路径规则手动匹配依赖文件，全程不执行代码：

• 绝对导入：将模块名的.替换为路径分隔符，拼接.py后缀后，在sys.path（项目根目录优先）中查找对应文件；若模块是包，则查找包目录下的__init__.py。
• 相对导入：根据当前文件的目录层级，计算相对路径（比如from .utils import func对应当前目录下的utils.py）。
• 对象定位：若需找到导入对象的定义文件，可解析目标模块的ast，定位对象的定义节点（仅需处理直接定义的对象，递归导入的可归为间接依赖）。

优势：无代码执行风险，适合安全敏感场景；可完全自定义解析规则适配你的定制需求。

3. 轻量工具配合自定义逻辑（替代pydeps） #

若不想用功能冗余的pydeps，可组合轻量工具实现核心需求：

• 用ast或tree-sitter提取目标文件的所有导入语句；
• 用上述importlib或路径匹配逻辑解析每个导入对应的文件路径；
• 若需生成依赖图，可使用pydot或networkx构建简单的有向图，仅保留直接依赖关系。

注意事项 #

• 处理相对导入时，必须将当前文件的父目录加入sys.path，否则会无法定位模块。
• 对于动态导入（如__import__(var)），静态解析工具无法捕获，需额外添加动态导入的识别逻辑。
• 命名空间包（无__init__.py的目录）需特殊处理，importlib.find_spec返回的origin为None时，需遍历sys.path查找对应目录。

内容的提问来源于stack exchange，提问作者Martim Afonso