如何跨包导入模块且保留目标包内的相对导入逻辑？

你的核心问题是：package_b内部用import module_bb这种隐式相对导入，在包内运行正常，但跨包导入时Python无法识别它是同包模块，而你又不想修改package_b里的大量导入语句。以下是几种比直接插入package_b路径更优的方案：

方案1：将my_app目录加入Python搜索路径 #

在package_a/module_a.py的开头添加这段代码，把项目根目录（my_app）加入sys.path：

import sys
from pathlib import Path

# 自动获取my_app的绝对路径，不用硬编码
my_app_dir = Path(__file__).parent.parent.parent.resolve()
if str(my_app_dir) not in sys.path:
    sys.path.insert(0, str(my_app_dir))

# 之后正常导入
from package_b import module_b

这样package_b会被识别为顶层包，module_b里的import module_bb会直接从package_b目录下查找，完美适配原有导入语句，还能保持项目结构的完整性，比直接插入package_b路径更规范。

方案2：用PYTHONPATH环境变量配置（无需修改代码） #

在运行你的应用前，把my_app的绝对路径添加到PYTHONPATH环境变量里：

• Linux/macOS：

  export PYTHONPATH="/绝对路径/my_app:$PYTHONPATH"
  

• Windows命令行：

  set PYTHONPATH=C:\绝对路径\my_app;%PYTHONPATH%
  

• Windows PowerShell：

  $env:PYTHONPATH = "C:\绝对路径\my_app;$env:PYTHONPATH"
  

这样Python启动时会自动把my_app纳入搜索路径，package_b作为顶层包被识别，内部的所有导入语句都不用改，适合开发环境快速配置。

方案3：在package_b内部封装路径处理（对调用方透明） #

在package_b的根目录下创建或修改__init__.py，加入以下代码：

import sys
from pathlib import Path

package_b_dir = Path(__file__).parent.resolve()
if str(package_b_dir) not in sys.path:
    sys.path.insert(0, str(package_b_dir))

这样只要导入package_b，就会自动把自身目录加入搜索路径，module_a里的from package_b import module_b调用完全不用改，路径处理逻辑被封装在package_b内部，对其他包无感知。

补充说明：为什么之前的setup.py无效 #

你用setup.py打包后仍出错，是因为Python 3默认禁用了隐式相对导入（就是import module_bb这种同包导入写法）。如果要通过setup.py解决，必须把package_b内部的导入改成显式相对导入（比如from . import module_bb），但这需要修改大量代码，不符合你的需求。所以上面的几种方案更适合你。

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