Python项目导入报错：import语句指向及修正方案咨询

项目目录结构 #

.
├── main.py
└── modules
    ├── __init__.py
    ├── error
    │   ├── __init__.py
    │   └── friendly_error.py
    └── search
        ├── __init__.py
        └── cog.py       <== 问题文件

运行main.py时，modules/search/cog.py中的导入语句from error.friendly_error import FriendlyError报错：No module named 'error'。VSCode无报错且可跳转定义，是因为编辑器自动将项目根目录纳入了代码感知路径，但Python运行时未识别。

1. 调整导入语句的两种方法 #

• 相对导入：利用相对路径定位同级的error模块，修改cog.py中的导入语句为：

  from ..error.friendly_error import FriendlyError
  

  注：..表示当前模块所在目录的上级目录（即modules目录），这种方式仅适用于作为包的一部分被导入的模块，直接运行cog.py会报错。

• 绝对导入：将项目根目录添加到Python的模块搜索路径，然后使用完整路径导入：

  1. 先在main.py开头添加代码，将根目录加入路径：

     import sys
     import os
     sys.path.append(os.path.dirname(os.path.abspath(__file__)))
     

  2. 然后修改cog.py中的导入语句为：

     from modules.error.friendly_error import FriendlyError
     

  这种方式兼容性更强，无论模块如何被调用都能正常导入。

2. 当前导入语句下Python的查找位置 #

当执行from error.friendly_error import FriendlyError时，Python会按以下顺序查找模块：

• 运行入口脚本（main.py）所在的目录（即项目根目录）
• Python标准库的安装目录
• 环境变量PYTHONPATH中指定的目录
• 第三方库所在的site-packages目录

由于error模块位于modules子目录下，不在上述默认搜索路径中，因此Python无法找到该模块。

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