Django项目移入子目录后无法从accounts.models导入模块问题排查

• 核心问题是项目的有效根目录没有被正确加入Python的模块搜索路径：你移动项目目录后，IDE或者Django运行环境的搜索路径配置没有同步更新，Python无法定位到backend目录下的accounts应用
• 次要排查点：如果accounts应用没有在Django配置的INSTALLED_APPS列表中注册，也会出现导入错误，不过你是移动目录后才触发的问题，大概率是路径配置问题
• 如果你使用PyCharm等IDE，也可能是IDE的源代码根目录标记错误，会出现语法检查报错但实际运行正常的情况

1. 基础配置检查 #

打开Django项目的settings.py，确认INSTALLED_APPS列表中已经添加了accounts应用，示例配置：

INSTALLED_APPS = [
    # Django默认内置应用
    'accounts',
    'example',
]

2. 修复Python模块搜索路径 #

你可以根据场景选择以下任意一种方案：

• 开发场景方案1：在manage.py开头添加路径配置代码，自动将项目根目录加入搜索路径

  import sys
  import os
  # 如果manage.py存放在backend目录下，用这行
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  # 如果manage.py存放在最外层的Project directory目录下，用这行
  sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), "backend"))
  

• 开发场景方案2（针对IDE飘红报错）：右键点击backend文件夹，选择「Mark Directory as」->「Sources Root」，IDE会自动将该目录识别为模块搜索根目录，报错提示会直接消失
• 部署场景方案：设置系统环境变量PYTHONPATH为backend目录的绝对路径，所有Python进程都会自动读取该路径作为模块搜索路径

3. 路径验证方法 #

你可以在example/views.py开头添加以下代码，打印当前Python的搜索路径列表，确认backend目录是否在列表中：

import sys
print(sys.path)

如果列表中没有backend目录的绝对路径，就说明是路径配置问题，按照上述方法补充即可。

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