运行Base.py导入mirage模块报No module named 'mirage'如何解决

运行Base.py过程中执行模块导入操作时触发模块未找到报错，具体报错信息如下：

from mirage.fact import Dataconfig
ModuleNotFoundError: No module named 'mirage'

当前编写的导入语句存在类名拼写偏差：from mirage.fact import Datsconfig。

• 先修正拼写错误：核对fact模块下实际定义的配置类名，你写的Datsconfig和报错提示的Dataconfig存在字母差异，拼写错误会直接导致导入失败，先把类名修正为和实际定义完全一致的写法。
• 核对模块搜索路径：Python导入自定义包时，默认会将当前执行入口脚本所在目录、系统环境变量PYTHONPATH包含的目录加入搜索列表，首先确认mirage文件夹所在的父目录是否在上述搜索路径范围内。如果运行Base.py时的工作目录不在mirage的父级位置，解释器就无法识别到mirage包。
• 检查包结构完整性：打开mirage文件夹、其下的fact文件夹，确认目录下是否存在__init__.py空文件。Python3.3+虽支持隐式命名空间包，但部分运行场景下缺少该文件会导致包识别异常，缺失时直接新建同名空文件即可。
• 路径问题临时验证：如果怀疑是路径问题，可以在Base.py所有导入逻辑的最开头加入如下代码，将mirage所在的父目录临时加入搜索路径，验证报错是否消失：

import sys
from pathlib import Path
# 以下路径根据你的实际目录层级调整，示例为取当前脚本上级的上级目录作为包搜索根路径
sys.path.append(str(Path(__file__).parent.parent.resolve()))

• 调整运行工作目录：运行脚本时将终端工作目录切换到mirage文件夹所在的项目根目录，再执行python 对应路径/Base.py，不要进入深层子目录后直接运行脚本。
• 可编辑模式安装项目：如果是长期开发的本地项目，在mirage所在的项目根目录下编写好pyproject.toml或setup.py配置文件后，执行pip install -e .将当前项目以可编辑模式安装到Python环境中，后续任意位置运行脚本都可以正常识别mirage包，是开发阶段最稳定的方案。
• 临时调试场景可使用前面提到的sys.path追加路径的方式，手动将包所在目录加入搜索列表即可，注意：该方法会硬编码路径，项目迁移时容易出现适配问题，仅适合临时调试，不推荐生产环境使用。

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