Python跨同级子目录导入模块对象报错如何解决

导入失败的核心原因是Python模块搜索路径sys.path与运行方式不匹配，和__init__.py是否创建无直接关联。Python运行单脚本时，默认仅将脚本自身所在目录加入搜索路径，如果你直接运行dirA/fileA.py，搜索路径下只有dirA目录，自然无法定位到同级的dirB包；而相对导入仅在文件被作为包内模块引用时生效，直接把脚本作为程序入口运行时，相对导入会直接抛出无已知父包的错误。

方式1：标准包运行模式（推荐，无代码侵入） #

• 先确认目录结构符合Python包规范，所有__init__.py留空即可，最终结构如下：

mycode
├── __init__.py
├── dirA
│   ├── __init__.py
│   └── fileA.py
└── dirB
    ├── __init__.py
    └── fileB.py

• 在fileA.py中使用基于项目根的绝对导入语句：

from dirB.fileB import object

• 调整运行命令：不要进入dirA目录直接执行脚本，切换到mycode文件夹的上一级目录，用-m参数将fileA作为包内模块启动：

python -m mycode.dirA.fileA

该模式下Python会自动将当前命令执行目录加入模块搜索路径，同时正确识别包层级关系，绝对导入、相对导入均可正常工作。

方式2：手动追加搜索路径（适合单脚本快速调试） #

如果需要直接运行fileA.py（比如IDE内点击运行按钮、进入dirA目录执行python fileA.py），可以在fileA.py的所有业务导入语句之前，手动将项目根目录加入Python搜索路径：

import sys
from pathlib import Path
# 从当前文件路径向上回溯2级，得到mycode根目录的绝对路径
project_root = Path(__file__).parent.parent.resolve()
sys.path.append(str(project_root))

# 后续正常写导入逻辑即可
from dirB.fileB import object

注意：该方式属于硬编码修改路径，仅适合临时调试场景，正式多人协作项目不推荐使用，容易引发路径冲突问题。

相对导入失效说明 #

类似from ..dirB.fileB import object的相对导入语法，要求当前文件必须归属明确的父包。如果将fileA.py作为顶层入口直接运行，Python会将其标记为__main__顶层模块，不存在父包属性，相对导入必然报错，这是Python的原生机制限制，不是配置错误。

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