Python集成RabbitMQ项目导入自定义类报模块不存在错误如何解决

报错核心原因 #

直接作为脚本执行consumer.py/publisher.py时，Python会将当前脚本所在的文件夹设为模块搜索路径的根节点，无法识别上层的services包结构，因此绝对导入找不到services模块，相对导入也会触发「无已知父包」的错误。

可落地的解决方法 #

方案1：遵循Python包规范，从根目录以模块方式运行 #

不需要修改任何导入代码，保留from services.lib.manager_mq import Manager的导入语句即可。
不要进入consumer/publisher目录直接运行脚本，切换到项目根目录（即包含services文件夹的上级目录），执行对应命令：

• 运行消费者：python -m services.consumer.consumer
• 运行生产者：python -m services.publisher.publisher
  这是最推荐的方案，不会破坏项目的包结构，也不需要额外添加冗余代码。

方案2：脚本开头动态添加搜索路径 #

如果需要保持直接在脚本所在目录运行的习惯，在consumer.py/publisher.py的最开头（所有导入语句之前）添加如下代码：

import sys
import os
# 把项目根目录加入Python模块搜索路径
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))

添加完成后，原有的导入语句不需要修改即可正常运行。

方案3：配置PYTHONPATH环境变量 #

将项目根目录的绝对路径添加到系统的PYTHONPATH环境变量中，配置完成后所有Python会话都可以识别services包，不需要修改代码也不需要调整运行命令。
临时生效（仅当前终端会话有效）：

• Linux/Mac 终端执行：export PYTHONPATH=你的项目根目录绝对路径:$PYTHONPATH
• Windows CMD执行：set PYTHONPATH=你的项目根目录绝对路径;%PYTHONPATH%
  永久生效可以将上述语句添加到系统环境变量配置文件中。

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