本文详解如何在 Django 项目外部目录中运行 Python 脚本并成功导入模型，重点解决 ModuleNotFoundError: No module named 'snippets' 错误，通过正确配置 Python 路径与 Django 设置实现跨目录 ORM 访问。
本文详解如何在 django 项目外部目录中运行 python 脚本并成功导入模型，重点解决 `modulenotfounderror: no module named 'snippets'` 错误，通过正确配置 python 路径与 django 设置实现跨目录 orm 访问。
要在独立于 Django 项目的目录（如 database/）中安全、可靠地使用 Django ORM 加载模型（例如 Snippet），关键在于让 Python 能够定位到 Django 项目根目录（即包含 manage.py 的目录），而非仅添加子目录到 sys.path。原始脚本将 parent_dir（即 Main-Project/）加入路径，但 Django 的应用模块（如 snippets）需以 Django 项目根目录为 Python 包上下文 才能被正确解析——这意味着 snippets 必须是该根目录下的一个可导入包（通常对应 django/ 或更常见的 myproject/ 目录），且 INSTALLED_APPS 中的 'snippets.apps.SnippetsConfig' 要求 snippets/ 文件夹内含有效的 __init__.py 和 apps.py。
根据你修正后的方案，实际项目结构中 django/ 目录应为 Django 项目根（即 manage.py 所在处）。因此，正确路径设置应指向该根目录：
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
import os
import sys
import django
from django.conf import settings
# 定位到 database/text-script.py 当前路径
current_dir = os.path.dirname(os.path.abspath(__file__))
# 向上两级：Main-Project/ → 再进入 django/（即 Django 项目根）
django_root = os.path.join(os.path.dirname(current_dir), 'django')
sys.path.append(django_root)
# ✅ 关键：DJANGO_SETTINGS_MODULE 必须相对于 django_root
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django.settings') # 假设 settings.py 在 django/django/settings.py → 此处应为 'django.settings'
# 若 settings.py 实际路径为 django/django/settings.py，则值应为 'django.settings'
# 若为 django/settings.py，则应为 'settings'
django.setup()
# 现在可安全导入模型
from snippets.models import Snippet # 注意：非 django.snippets.models —— 因为 django_root 已在 sys.path 中⚠️ 重要注意事项：
- os.environ.setdefault('DJANGO_SETTINGS_MODULE', ...) 的模块路径必须相对于已加入 sys.path 的 django_root。例如，若 settings.py 位于 django/django/settings.py，则值应为 'django.settings'；若在 django/settings.py，则为 'settings'。
- 确保 snippets/ 目录下存在 __init__.py，且其 apps.py 中 SnippetsConfig 类定义正确，default_app_config（如使用旧版 Django）或 default_auto_field 配置无误。
- 运行脚本前，建议先激活 Django 项目的虚拟环境，避免依赖冲突。
- 推荐在脚本开头添加 django.setup() 调用前检查 settings.configured，防止重复配置：
if not settings.configured:
django.setup()✅ 最终验证：运行 python database/text-script.py 时，若不再报 ModuleNotFoundError，且 Snippet.objects.all() 可正常查询，则配置成功。此方法使外部脚本完全复用 Django 的数据库连接、模型逻辑与信号机制，是生产环境中批量数据导入的标准实践。
