本文详解如何在 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 (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 语句便于调试执行状态。
运行前请确认：
- 当前工作目录可任意（脚本内已用绝对路径处理）；
- 数据库服务已启动，且 django/settings.py 中 DATABASES 配置正确；
- 若使用虚拟环境，请先激活后再执行 python database/text-script.py。
通过精准控制模块搜索路径与 Django 配置入口，即可在隔离目录中无缝复用 Django ORM，实现安全、可维护的数据批量操作。
