在 django 项目外部（如独立 python 脚本）使用 `django.setup()` 初始化 orm 时，需正确设置 python 路径与 `django_settings_module` 环境变量，否则即使 `installed_apps` 已注册应用，仍会因模块未被发现而报 `modulenotfounderror`。
在非 Django Web 请求上下文（例如 main.py、数据迁移脚本或 CLI 工具）中使用 Django ORM，必须完成两个关键步骤：环境初始化 和 Python 模块路径注册。你当前的错误 ModuleNotFoundError: No module named 'model_db' 并非因为 settings.py 中未声明 model_db，而是因为 Python 解释器根本无法定位该包——django.setup() 依赖标准的 Django 项目结构和可导入路径，而你的目录嵌套（DATABASE/Django_ORM/Django_ORM/settings.py）导致模块查找失败。
✅ 正确做法：用 DJANGO_SETTINGS_MODULE + sys.path 显式引导
不要手动调用 settings.configure()（它绕过 Django 的 App 加载机制，且不支持 INSTALLED_APPS 中的相对路径解析），而应通过标准方式启动：
import os
import sys
import django
from django.conf import settings
# 1. 将 Django 项目根目录（即 manage.py 所在目录）加入 Python 路径
# 根据你的结构：PROJECT_ROOT = ./DATABASE/Django_ORM/
PROJECT_ROOT = os.path.join(os.path.dirname(__file__), "DATABASE", "Django_ORM")
sys.path.append(PROJECT_ROOT)
# 2. 设置环境变量，指向 settings 模块的 Python 路径（注意：是模块路径，不是文件路径）
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "Django_ORM.settings")
# 3. 初始化 Django —— 此时会自动加载 INSTALLED_APPS 并解析 model_db
django.setup()
# ✅ 现在可以安全导入模型
from model_db.models import YourModel # 注意：直接 from model_db 导入，无需 DATABASE.Django_ORM.model_db? 关键说明： DJANGO_SETTINGS_MODULE="Django_ORM.settings" 表示从 sys.path 中的某个目录开始，以 Python 包形式导入 Django_ORM.settings 模块；因此 Django_ORM/ 必须是可导入的包（含 __init__.py，你已满足）。 model_db 是 Django_ORM 包下的子包，只要 Django_ORM/ 在 sys.path 中，from model_db.models 就能被解析。 ❌ 避免 settings.configure(...)：它仅用于极简场景（如无 settings.py 的测试），不触发 App 注册逻辑，也无法识别 INSTALLED_APPS 中的字符串路径。
⚠️ 常见陷阱与验证建议
- 检查 __init__.py 是否存在：确保 DATABASE/Django_ORM/Django_ORM/__init__.py 和 DATABASE/Django_ORM/model_db/__init__.py 均为空文件（存在即可），否则 Python 不视其为包。
-
验证路径有效性：在 main.py 开头添加调试代码：
print("sys.path[0]:", sys.path[0]) print("PROJECT_ROOT:", PROJECT_ROOT) print("Can import Django_ORM?", bool(__import__("Django_ORM"))) -
避免硬编码路径：生产环境建议使用 pathlib 动态定位：
from pathlib import Path PROJECT_ROOT = (Path(__file__).parent / "DATABASE" / "Django_ORM").resolve()
✅ 最终工作流程总结
| 步骤 | 操作 | 目的 |
|---|---|---|
| 1️⃣ | sys.path.append(PROJECT_ROOT) | 让 Django_ORM 成为顶层可导入包 |
| 2️⃣ | os.environ.setdefault("DJANGO_SETTINGS_MODULE", "...") | 告知 Django 加载哪个 settings 模块 |
| 3️⃣ | django.setup() | 触发完整初始化：读取 settings → 加载 INSTALLED_APPS → 注册模型 → 连接数据库 |
| 4️⃣ | from model_db.models import ... | 直接导入，无需前缀路径 |
完成上述配置后，model_db 将被 Django 正确识别，所有模型、管理器和数据库操作均可正常使用。这是 Django 官方推荐的“Standalone Django Usage”模式，稳定兼容 Django 4.x / 5.x。
