Python跨目录导入冲突：如何统一导入语句兼容两种运行场景？

项目结构回顾 #

Application
├── app
│   ├── data/
│   ├── utils/
│   │   └── utils.py
│   └── main.py
├── utils2/
│   └── utils2.py
└── main2.py

核心矛盾：app/utils/utils.py中的导入语句，在运行app/main.py时需用from data import *，运行main2.py时需用from app.data import *，导致冲突。

方法1：使用相对导入（推荐） #

• 在app目录下新增空的__init__.py文件，将app标记为Python包
• 修改utils.py中的导入语句为：

  from .data import *
  

• 运行方式说明：
  • 运行main.py时，需在Application目录下执行命令：python -m app.main（而非进入app目录直接运行python main.py）
  • 运行main2.py时，直接在Application目录下执行python main2.py即可

这种方式符合Python包的规范，从根源上避免导入路径冲突。

方法2：动态调整模块搜索路径 #

在utils.py的开头添加以下代码，动态将app目录加入Python的模块搜索路径：

import sys
import os

# 获取当前utils.py所在目录的绝对路径
utils_path = os.path.abspath(__file__)
# 向上回溯一级得到app目录路径
app_path = os.path.dirname(os.path.dirname(utils_path))

# 确保app目录在搜索路径最前面，优先匹配
if app_path not in sys.path:
    sys.path.insert(0, app_path)

# 统一使用from data import *导入
from data import *

这种方式无需修改原有导入语句，通过动态调整sys.path让两种场景都能找到data模块。

方法3：设置PYTHONPATH环境变量 #

在运行脚本前，将Application目录添加到PYTHONPATH环境变量：

• Windows命令行：

  set PYTHONPATH=你的Application目录绝对路径
  

• Linux/macOS终端：

  export PYTHONPATH=/你的Application目录绝对路径
  

之后utils.py中统一使用from app.data import *，无论运行main.py还是main2.py，Python都会从PYTHONPATH指定的目录开始搜索模块。

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