Django多App跨应用导入模型报No module named 'apps'错误

报错根因 #

报错核心是Python模块搜索路径未包含项目根目录：直接运行non_app_dir/work.py时，解释器默认将脚本所在目录/project/apps/non_app_dir/作为搜索起点，没有加载项目根目录/project/的路径，因此无法识别顶层的apps包。
额外配置误区：non_app_dir没有apps.py、models.py等Django应用必需文件，不属于合法Django应用，写入INSTALLED_APPS不会生效，反而可能触发应用加载校验错误。

解决方法 #

方案1：通过Django入口运行脚本（最符合开发规范，优先使用） #

所有依赖Django配置、ORM的脚本不要直接运行，统一通过Django提供的入口执行，完全避免路径问题：

• 临时调试场景：在manage.py所在的项目根目录执行命令进入Django shell

  python manage.py shell
  

  进入交互环境后再导入执行逻辑：

  from apps.non_app_dir.work import testModel
  testModel()
  

• 重复执行场景：将脚本封装为Django自定义管理命令，在合法应用下创建management/commands/目录存放命令逻辑，后续可直接通过python manage.py 自定义命令名执行。

方案2：临时注入项目路径（适合单文件直接运行调试） #

如果需要直接运行work.py文件，在文件最顶部、所有跨包导入前添加路径初始化代码，同时完成Django环境加载：

import sys
import os
# 定位到项目根目录/project/并加入搜索路径
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(BASE_DIR)

# 加载Django配置
import django
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'core.settings')
django.setup()

# 配置完成后再导入模型、编写业务逻辑
from apps.app1.models import MyModel

def testModel():
    test = MyModel.objects.all()
    print(test)

if __name__ == "__main__":
    testModel()

注意：直接运行依赖Django能力的脚本时，必须先执行django.setup()完成环境初始化，否则会出现Django未加载的关联报错。

方案3：配置全局PYTHONPATH（非必要不推荐） #

将项目根目录路径加入系统PYTHONPATH环境变量，可让解释器全局识别apps包，但该方式会修改全局Python环境，多项目并行开发时容易出现路径冲突、依赖污染问题。

配置修正 #

删除INSTALLED_APPS配置中的'apps.non_app_dir'项，该配置仅用于注册合法Django应用，非应用类的工具目录无需加入。

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