Git Subtree导入报错求助：子仓库跨目录模块导入失败问题

将B仓库作为subtree添加到A仓库的B文件夹后，B内部的目录结构变为A/B/C和A/B/D。原B仓库中C模块里的from D import d导入语句是基于B作为根目录的，但在A仓库环境下，Python的模块搜索路径默认不包含A/B，因此无法找到D模块导致报错。

以下是几种可行的解决方案：

• 使用相对导入
  修改C模块中的导入语句为相对路径形式：

  from ..D import d
  

  这种方式符合Python包的规范，但注意如果直接运行C模块作为主程序时，相对导入会失效（Python不允许主模块使用相对导入）。

• 动态添加模块搜索路径
  在C模块的开头添加代码，将B目录加入Python的sys.path：

  import sys
  import os
  # 获取当前文件的父目录的父目录，也就是B目录的绝对路径
  b_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  if b_dir not in sys.path:
      sys.path.append(b_dir)
  # 原来的导入语句可以保留
  from D import d
  

  这种方法不需要修改原有导入逻辑，能直接适配新的目录结构。

• 配置Python环境变量
  在运行A仓库内的代码前，将A/B目录添加到PYTHONPATH环境变量中：

  • Linux/macOS终端：

    export PYTHONPATH="/path/to/A/B:$PYTHONPATH"
    

  • Windows命令行：

    set PYTHONPATH=C:\path\to\A\B;%PYTHONPATH%
    

  这种方式不需要修改任何代码，但需要每次运行前配置环境，或者写入shell配置文件（如~/.bashrc）永久生效。

内容的提问来源于stack exchange，提问作者james L