如何在独立目录中正确加载 Django 模型以操作数据库-Python教程-PHP中文网

本文详解如何在 Django 项目外部的 Python 脚本中安全初始化 Django 环境并导入模型，解决因路径配置错误导致的 ModuleNotFoundError: No module named 'snippets' 问题。

本文详解如何在 django 项目外部的 python 脚本中安全初始化 django 环境并导入模型，解决因路径配置错误导致的 `modulenotfounderror: no module named 'snippets'` 问题。

在 Django 项目之外运行数据库脚本（如批量导入文本文件）是一种常见需求，但极易因 Python 模块路径和 Django 设置配置不当而失败。核心问题不在于代码逻辑，而在于 Django 初始化前的环境准备是否完整：必须确保 sys.path 包含 Django 项目的根目录（即包含 manage.py 或 settings.py 所在包的上层目录），且 DJANGO_SETTINGS_MODULE 指向正确的配置路径。

根据你提供的项目结构：

Main-Project/
  database/          ← 脚本所在目录
    text-script.py
    text-files/
  django/            ← Django 项目根目录（应含 manage.py）
    django/
      settings.py    ← 实际设置模块为 django.settings
    snippets/
      models.py

原代码中 sys.path.append(parent_dir) 将 Main-Project/ 加入路径，但 snippets 并非该目录下的直接子包——它位于 django/snippets/ 下。因此 Python 无法解析 'django.snippets.models'。正确做法是将 Django 项目根目录（即 django/ 文件夹） 加入 sys.path，而非其父目录。

以下是修正后的 text-script.py 完整实现（含健壮性增强）：

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

import os
import sys
import django
from django.conf import settings

# 1. 定位 Django 项目根目录（即包含 settings.py 的 django/ 目录）
current_dir = os.path.dirname(os.path.abspath(__file__))
project_root = os.path.join(current_dir, '..', 'django')  # ← 关键修正：指向 django/ 目录
project_root = os.path.abspath(project_root)
sys.path.append(project_root)

# 2. 配置 Django 环境
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django.settings')
django.setup()

# 3. ✅ 此时可安全导入模型（注意包路径与 INSTALLED_APPS 一致）
from snippets.models import Snippet  # 不再用 django.snippets，因为 django/ 已在 sys.path 中

def import_articles(directory):
    for filename in os.listdir(directory):
        if filename.endswith('.txt'):  # ⚠️ 修正拼写：endwith → endswith
            file_path = os.path.join(directory, filename)
            with open(file_path, 'r', encoding='utf-8') as f:
                content = f.read()
            Snippet.objects.create(filename=filename, content=content)
            print(f"Imported: {filename}")

if __name__ == '__main__':
    text_dir = os.path.join(current_dir, 'text-files')
    import_articles(text_dir)

关键注意事项：

✅ sys.path.append(project_root) 必须指向 django/ 目录（即 Main-Project/django），而非 Main-Project；这是模块发现的前提。
✅ DJANGO_SETTINGS_MODULE 值为 'django.settings'（对应 django/django/settings.py），而非 'django.django.settings' —— 后者多了一层 django.。
✅ INSTALLED_APPS 中已声明 'snippets.apps.SnippetsConfig'，因此 from snippets.models 可直接导入（Django 会自动识别应用包）。
⚠️ 务必使用 django.setup() 在导入模型前调用，否则 ORM 未初始化将报错。
? 建议添加 encoding='utf-8' 防止中文文本读取异常；print 语句便于调试执行状态。

运行前请确认：