Django项目跨文件夹导入模块的正确方法咨询

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

项目根目录/
├── backend/          # Django项目目录
│   ├── app/
│   │   └── views.py  # 需要导入模块的文件
│   └── manage.py
└── main/             # 目标模块所在目录
    ├── __init__.py
    └── Text_Generator.py

你之前的两种导入方式报错原因：

• 相对导入from ...main.Text_Generator import *失败：相对导入无法超出当前顶级包（backend是Python识别的顶级包），而main在backend外部，无法通过相对导入访问。
• 绝对导入from main.Text_Generator import *失败：Python的sys.path中未包含项目根目录，找不到main模块。

解决方案1：修改Django的manage.py添加路径 #

打开backend/manage.py，在文件开头添加以下代码，将项目根目录（backend的父目录）加入Python路径：

import sys
import os

# 获取项目根目录（backend文件夹的上级目录）
PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
sys.path.append(os.path.dirname(PROJECT_ROOT))

修改后，即可在backend/app/views.py中正常使用绝对导入：

from main.Text_Generator import *

解决方案2：设置PYTHONPATH环境变量 #

启动Django服务器前，将项目根目录添加到PYTHONPATH环境变量中：

• Linux/macOS终端：

export PYTHONPATH=/path/to/你的项目根目录:$PYTHONPATH

• Windows命令提示符：

set PYTHONPATH=C:\path\to\你的项目根目录;%PYTHONPATH%

设置完成后启动服务器，同样可以用from main.Text_Generator import *完成导入。

解决方案3：调整目录结构（可选） #

如果业务允许，将main文件夹移动到backend目录下，目录结构变为：

项目根目录/
└── backend/
    ├── app/
    │   └── views.py
    ├── main/
    │   ├── __init__.py
    │   └── Text_Generator.py
    └── manage.py

此时可使用相对导入：

from ...main.Text_Generator import *

或者绝对导入：

from main.Text_Generator import *

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