Django项目模块导入异常求助：ModuleNotFoundError及IDE红线问题

问题描述 #

1. 单独运行脚本模块导入报错 #

运行archivodetest.py时，导入语句from config.wsgi import *抛出ModuleNotFoundError: No module named 'config.wsgi'，但通过runserver启动整个项目完全正常。
项目结构如下：

NombreDelProyecto
--app
---config
----__init__.py
----asgi.py
----settings.py
----wsgi.py
----db.py
---core
----general
----login
----user
----archivodetest.py

2. IDE导入路径提示与运行逻辑矛盾 #

视图中编写from core.general.forms import ActividadForm时，IDE显示红色下划线，但项目实际运行正常；改为from app.core.general.forms import ActividadForm后IDE无红线提示，但运行时抛出ModuleNotFoundError: No module named 'app'。

解决方案 #

一、修复单独运行脚本的模块导入问题 #

Django通过runserver启动时，会自动将项目根目录（NombreDelProyecto）加入Python的模块搜索路径sys.path，但单独运行脚本时不会自动处理，需手动添加路径。
修改archivodetest.py的开头代码：

import os
import sys

# 获取项目根目录的绝对路径（从当前脚本位置向上回溯两级）
BASE_DIR = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
# 将根目录加入模块搜索路径
sys.path.append(BASE_DIR)

# 后续再执行Django相关导入
from config.wsgi import *
from django.template.loader import get_template
from weasyprint import HTML, CSS
from config import settings

同时注意：项目结构中你写的wsgy.py应为笔误，实际文件名需是wsgi.py，拼写错误也会导致模块找不到。

二、解决IDE导入路径提示异常问题 #

IDE显示红线是因为未识别Django的模块搜索规则，而Django运行时会自动读取INSTALLED_APPS配置识别应用目录，因此from core.general.forms import ActividadForm的写法本身是正确的，无需修改导入语句。
只需配置IDE的Django项目路径即可消除红线：

• 以PyCharm为例：打开File > Settings > Languages & Frameworks > Django，勾选Enable Django support，设置Django project root为NombreDelProyecto文件夹，Settings为app/config/settings.py。
• 其他IDE操作逻辑类似，核心是告诉IDE当前Django项目的根目录和配置文件位置，让它正确识别core这类应用模块的路径。

内容的提问来源于stack exchange，提问作者Ivan Leon Oliver