已安装自定义Python包但模块无法识别，如何解决导入冲突？

云上老周

2026-6-13

解决Python包导入冲突的两种方案

你的问题核心是包内模块导入方式在「安装后使用」和「直接运行模块脚本」两种场景下的兼容性，以下是两种可行的解决办法：

方案一：使用绝对导入（推荐）

修改main.py中的导入语句，明确从mypackage包导入子模块：

from mypackage import scrapper
from mypackage import helpers

def get_books():
    ...

两种场景的运行方式：

新项目中使用：保持你原来的测试代码不变，安装后正常运行：
```
from mypackage import main
print(main.get_books())
```
直接运行main.py：不要直接执行python main.py，而是在包含内层mypackage的父目录（即和setup.py同级的目录）下，用模块方式运行：
```
python -m mypackage.main
```
这种方式会让Python将当前目录视为包的根路径，正确识别mypackage下的子模块。

方案二：保留相对导入，兼容直接运行

如果偏好使用相对导入，可在main.py末尾添加一段代码，当脚本被直接运行时，手动将包路径加入Python的搜索路径：

from . import scrapper
from . import helpers

def get_books():
    ...

# 处理直接运行脚本的情况
if __name__ == "__main__":
    import sys
    from pathlib import Path
    # 将当前文件所在目录的父目录加入sys.path，让Python识别mypackage为包
    sys.path.append(str(Path(__file__).parent.parent))
    # 重新导入（此时已能识别包结构）
    from mypackage import scrapper, helpers
    # 执行功能
    print(get_books())