启动Django服务器时提示ModuleNotFoundError：找不到psychology_app模块

排查与解决步骤 #

针对这个错误，按以下顺序逐一排查修复：

1. 确认应用目录结构 #

检查psychology_project根目录（和manage.py同级）下是否存在psychology_app文件夹，且文件夹内必须包含__init__.py、apps.py、models.py这些Django应用的核心文件。如果应用未创建，先执行命令生成：

python manage.py startapp psychology_app

2. 修正INSTALLED_APPS配置 #

打开项目根目录的settings.py，找到INSTALLED_APPS列表，确认已正确添加psychology_app：

• 两种正确添加方式：

  # 方式1：直接添加应用名称
  INSTALLED_APPS = [
      # 其他默认应用
      'psychology_app',
  ]
  

  # 方式2：使用AppConfig类（更规范）
  INSTALLED_APPS = [
      # 其他默认应用
      'psychology_app.apps.PsychologyAppConfig',
  ]
  

• 注意检查拼写，避免大小写、单词错误。

3. 确保Python路径包含项目目录 #

如果应用不在Python默认搜索路径中，在settings.py开头添加代码，将项目根目录加入路径：

import sys
import os
sys.path.append(os.path.dirname(os.path.abspath(__file__)))

4. 验证虚拟环境（如果使用） #

• 确保激活了项目对应的虚拟环境（Windows系统）：

venv\Scripts\activate

• 激活后可重新安装Django依赖，避免环境不一致：

pip install django

5. 清理缓存并重启 #

• 清理Django缓存：

python manage.py clearcache

• 停止当前服务器，重新执行启动命令：

python manage.py runserver

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