Django项目子文件夹中无法导入模块的问题求助

这问题我之前开发Django项目时也碰到过，本质是Python模块搜索路径（sys.path）和Django环境配置在不同目录下的差异导致的，下面给你几个靠谱的解决办法：

原因分析 #

当你在项目根目录（manage.py所在目录）运行Python时：

• 虚拟环境的site-packages目录已经被加入到Python的模块搜索路径中，所以能找到django包；
• 同时，根目录本身也在sys.path里，Django能自动识别项目的配置文件（settings.py），相关模块导入自然正常。

而进入子目录后，当前工作目录变成了子文件夹，Python默认的搜索路径会以当前子目录为起点，加上虚拟环境的路径（如果激活正常的话），但如果是依赖项目配置的操作，或者虚拟环境路径没正确加载，就会出现导入失败。

解决办法 #

1. 使用Django自带的Shell进入环境 #

这是最省心的方式，直接在子目录下运行：

python ../manage.py shell

这样会自动加载Django的所有环境配置，包括正确的模块路径和settings，你再执行import django或者from django.core.mail import EmailMessage, send_mail就完全没问题了。

2. 手动添加项目根目录到Python搜索路径 #

如果你需要在自己的脚本里导入模块，可以在代码开头加上这段，把项目根目录（manage.py所在目录）加入sys.path：

import sys
import os

# 获取项目根目录的绝对路径
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 把根目录加入搜索路径
sys.path.append(project_root)

# 现在可以正常导入了
import django
from django.core.mail import EmailMessage, send_mail

3. 检查并重新激活虚拟环境 #

有时候切换目录后，虚拟环境的路径可能没正确加载，你可以在子目录下重新激活一次：

# Mac/Linux
source ../venv/bin/activate

# Windows（PowerShell）
../venv/Scripts/Activate.ps1

激活后再运行Python，应该就能正常导入django模块了。

4. 设置PYTHONPATH环境变量 #

运行Python时，直接指定项目根目录为PYTHONPATH：

PYTHONPATH=../ python

这样Python会把项目根目录加入搜索路径，导入操作就正常了。

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