Python包导入问题：如何让模块既作为脚本运行又能跨包导入？

问题场景 #

给定如下Python包结构：

Package\
    __init__.py
    module1.py
    Subpackage\
        __init__.py
        module2.py
        module3.py

核心需求：

• module2可在Package\Subpackage目录下直接作为脚本运行
• module1可在Package目录下直接作为脚本运行
• module1导入module2时不会出现ModuleNotFoundError

解决方案 #

方法1：兼容两种导入模式的动态处理

在module2.py开头添加以下代码，自动适配"作为脚本运行"和"被其他模块导入"两种场景：

import sys
from pathlib import Path

# 将当前脚本所在目录加入Python搜索路径（脚本直接运行时用）
sys.path.append(str(Path(__file__).resolve().parent))

try:
    # 优先尝试相对导入（被module1等外部模块导入时用）
    from . import module3
except ImportError:
    # 相对导入失败则直接导入（脚本单独运行时用）
    import module3

这种方式无需改变运行习惯，不管是直接运行module2.py，还是通过module1导入module2，都能正确加载module3。

方法2：遵循Python包规范的绝对导入

采用绝对导入方式，并通过-m参数从包的父目录启动脚本：

1. 修改module2.py的导入语句为绝对导入：

   from Package.Subpackage import module3
   

2. 运行module1时，在Package的父目录执行：

   python -m Package.module1
   

3. 运行module2时，在Package的父目录执行：

   python -m Package.Subpackage.module2
   

这种方式符合Python官方包设计规范，但需要统一从包的父目录启动脚本，不能直接在模块所在目录运行.py文件。

方法3：借助子包初始化文件简化兼容

在Subpackage/__init__.py中添加：

from . import module3

然后在module2.py中使用如下导入逻辑：

try:
    from . import module3
except ImportError:
    import module3

原理和方法1一致，只是借助子包的初始化文件提前声明模块，让相对导入的场景更顺畅。

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