如何实现Python项目跨目录运行时的正确模块导入？

针对你给出的项目结构，以下几种方案可以实现任意文件运行时导入语句均生效：

方案一：动态添加项目根目录到sys.path #

在需要跨目录导入的文件（如app.py）开头添加代码，手动将Project1根目录加入Python的模块搜索路径：

import sys
import os

# 获取当前文件所在目录的父目录（即Project1根目录）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if project_root not in sys.path:
    sys.path.append(project_root)

# 正常使用绝对导入
from debug_routines.debug import dprint

修改后，无论直接运行app.py还是通过main.py调用，导入逻辑都能正常工作。

方案二：以包模块方式运行文件 #

利用Python的包机制，通过-m参数运行模块，此时可使用相对导入：

1. 修改app.py中的导入语句为相对导入：

from ..debug_routines.debug import dprint

2. 切换到Project1根目录，执行以下命令运行app.py：

python -m app.app

这种方式符合Python包的设计规范，但必须从根目录用-m参数启动，不能直接运行子目录下的脚本文件。

方案三：统一根目录作为运行入口 #

所有功能都通过根目录的脚本（如main.py）启动，避免直接运行子目录文件：

• 在main.py中导入并调用app.py的功能：

from app.app import your_function

if __name__ == "__main__":
    your_function()

• 若需单独测试app.py，可在Project1根目录创建test_app.py，同样基于根目录的绝对导入调用app.py。

关于Python导入系统的说明 #

Python导入系统并非不够健壮，而是它严格区分独立脚本和包内模块两种运行场景：

• 直接运行脚本时，脚本所在目录会被加入sys.path，仅能导入该目录下或已安装的第三方模块。
• 当作为包的一部分被导入（或用-m参数运行）时，Python会基于包层级结构查找模块，此时相对导入和绝对导入均可正常工作。
  遵循这一设计逻辑，就能避免绝大多数导入问题。

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