Python同模块（目录）内导入类时出现ImportError

目录结构 #

ProjectDirectory/
├── Main.py
└── EntitiesDirectory/
    ├── __init__.py
    ├── Trip.py
    └── Plan.py

问题详情 #

• __init__.py文件为空，Plan.py中定义了Plan类
• Trip.py原代码：

from Plan import Plan
class Trip():
    def __init__(self, plan:"Plan"):
        # 处理plan对象的逻辑
        pass

• 异常情况：在EntitiesDirectory目录内直接运行Trip.py时正常，但在Main.py中执行from EntitiesDirectory.Trip import Trip时，报错No module named 'Plan'
• 已尝试的无效导入方式：
  • from .Plan import Plan
  • from EntitiesDirectory.Plan import Plan
  • from . import Plan
    均提示相对目录错误：无父模块，使用环境为Anaconda下的Python 3.11

解决方案 #

问题根源是模块运行方式的差异：直接运行Trip.py时它是顶层脚本，从Main.py导入时它是包的子模块，两种场景下Python的模块搜索路径规则不同。

方案1：使用相对导入并以包方式运行 #

修改Trip.py的导入语句为相对导入：

from .Plan import Plan
class Trip():
    def __init__(self, plan:"Plan"):
        # 处理plan对象的逻辑
        pass

注意：此时不能再直接在EntitiesDirectory内运行Trip.py，若要测试需从项目根目录执行：

python -m EntitiesDirectory.Trip

Main.py中可正常导入使用。

方案2：使用绝对导入并确保项目根目录在搜索路径 #

修改Trip.py的导入语句为绝对路径：

from EntitiesDirectory.Plan import Plan
class Trip():
    def __init__(self, plan:"Plan"):
        # 处理plan对象的逻辑
        pass

确保ProjectDirectory在Python搜索路径中，可通过两种方式实现：

1. 直接在ProjectDirectory目录下运行Main.py：

python Main.py

2. 或在Main.py开头添加路径配置：

import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent))

from EntitiesDirectory.Trip import Trip

方案3：兼容两种运行场景（可选） #

若需要同时支持直接运行Trip.py和被导入的场景，可添加判断逻辑：

try:
    # 作为包子模块导入时用相对导入
    from .Plan import Plan
except ImportError:
    # 作为顶层脚本运行时用绝对导入
    from Plan import Plan

class Trip():
    def __init__(self, plan:"Plan"):
        # 处理plan对象的逻辑
        pass

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