Django启动服务器报错：无法从JTOrderApp导入Companies的问题排查

常见触发原因 #

• 模型类不存在或名称错误：JTOrderApp的models.py中没有定义名为Companies的模型，或是你拼写错误（比如实际模型是Company单数形式）
• 导入路径错误：导入语句写法错误，比如使用from JTOrderApp import Companies而非正确的from JTOrderApp.models import Companies或from .models import Companies（除非你在JTOrderApp/__init__.py中显式导出了该模型）
• 循环导入问题：JTOrderApp内部或与其他应用间存在循环依赖，比如models.py导入了views.py的内容，同时views.py又导入models.py的Companies
• 应用未正确注册：JTOrderApp未添加到settings.py的INSTALLED_APPS列表中，导致Django无法识别该应用的模型
• 目录结构异常：JTOrderApp目录缺少__init__.py文件（Python 3.3+虽不强制，但Django依赖它识别应用），或是models.py文件名拼写错误

快速排查步骤 #

• 打开JTOrderApp/models.py，确认是否存在名称完全匹配的Companies模型类，注意大小写、单复数差异
• 检查所有导入Companies的文件（如views.py），修正导入路径为正确的模型导入格式
• 排查代码中的循环导入：查看models.py和其他相关文件，移除互相导入的逻辑
• 验证settings.py的INSTALLED_APPS，确保'JTOrderApp'已添加其中
• 检查项目结构：确认JTOrderApp目录下有__init__.py（空文件即可），models.py文件名无误

内容的提问来源于stack exchange，提问作者Derick T.