能否直接运行包含相对导入的Python模块？

核心原因 #

Python的相对导入是为包内部模块间的引用设计的。如果直接运行某个模块（比如python my_module.py），该模块会被当作顶层脚本而非包的一部分，此时Python无法识别相对导入的层级关系，自然会报错。

有效解决方案 #

1. 正确使用python -m命令

这是官方推荐的方式，但必须注意运行路径：

• 假设你的项目结构如下：

  my_project/
      parent_dir/
          relative_path.py
          target_module.py  # 包含`from ..relative_path import Something`的模块
  

• 你需要进入my_project目录，然后执行：

  python -m parent_dir.target_module
  

• 之前报错的原因基本是运行路径不对，比如在parent_dir下直接运行python -m target_module，此时Python无法识别上层的包结构，导致相对导入失效。

2. 手动添加项目路径（应急方案，不推荐）

如果非要直接运行脚本，可以手动把项目根目录添加到Python的搜索路径中：

import sys
from pathlib import Path

# 将项目根目录（当前脚本的父级父目录）加入sys.path
sys.path.append(str(Path(__file__).resolve().parent.parent))

# 之后直接用绝对导入
from parent_dir.relative_path import Something

注意：这种方法会破坏包的结构独立性，大型项目中容易引发命名冲突，仅临时应急使用。

3. 规范项目结构（最优解）

把项目设计成标准的Python包结构，示例如下：

my_project/
    pyproject.toml  # 项目配置文件
    src/
        my_package/
            __init__.py
            sub1/
                module_a.py
            sub2/
                module_b.py  # 这里可以用`from ..sub1.module_a import ...`

• 开发时执行pip install -e .将包安装为可编辑模式，之后无论在哪个路径下，都能直接导入包内模块，也可以通过python -m my_package.sub2.module_b正常运行模块。

为什么你的try-except方案失效 #

当使用from ..x import ...这种上层目录的相对导入时，Python会先检查当前模块的__package__属性。如果是直接运行脚本，__package__为空，此时Python会直接抛出ImportError，不会进入except分支，所以你的第二个try-except逻辑根本无法触发。

内容的提问来源于stack exchange，提问作者Paweł Pietraszko