在脚本中单独使用Django ORM模型的方法与注意事项

周末不加班

发布时间：2026-10-13 | 4人浏览过

原创

本文介绍如何在非Django项目中通过脚本直接调用ORM模型。核心步骤包括设置DJANGO_SETTINGS_MODULE环境变量并调用django.setup()初始化环境。重点强调代码导入顺序：必须先完成环境配置再import models，否则将触发ImproperlyConfigured错误。

Django ORM独立脚本使用场景

在测试Django模块时，若无需启动完整项目，可尝试在单个文件中运行代码。利用if __name__ == '__main__':结构编写脚本，既能验证逻辑，又不会干扰正常的项目运行流程。

实现方式

常规方案

通常的做法是使用'python manage.py shell'命令进入交互环境，但这并非所有场景下的最佳选择。

脚本初始化配置方法

更优的解决方案

在脚本中导入模型之前，需先执行以下初始化代码：

基础环境配置代码


import os, sys
BASE_DIR = os.path.dirname(os.path.abspath(__file__)) # 定位到你的django根目录
sys.path.append(os.path.abspath(os.path.join(BASE_DIR, os.pardir)))
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "dj_tasks.settings") # 你的django的settings文件

完成上述配置后，再执行'from XXXX.models import XXX'即可正常导入模型，不再报错。

常见错误与解决策略

补充说明：Django在外部文件中操作models时的常见陷阱

具体代码示例如下：

错误示例代码分析


from pv_server.models import IVCurvesInfo, FaultType
import os
import django
 
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'PV_Moniter.settings')
django.setup()
 
def add_fault_type(fault_list, true_data_list, fault_decription_list=None):
  for item in fault_list:
    idx = fault_list.index(item)
    true_data = true_data_list[idx]
    fault_decription = fault_decription_list[idx] if (fault_decription_list and fault_decription_list[idx]) \
      else None
 
    FaultType.addFault.create_faultType(item, true_data,fault_decription)
 
if __name__ == '__main__':
  add_fault_type(['normal', 'partial shadow_1', 'partial shadow_2',
          'partial shadow_3', 'short circuit_1', 'short circuit_2',
          'degradation_1', 'degradation_2', 'open_circuit'],
          [0] * 9)
  print("Done!")

基于上述代码进行分析

若处理不当，通常会遇到

django.core.exceptions.ImproperlyConfigured: Requested setting INSTALLED_APPS, but settings are not configured. You must either define the environment variable DJANGO_SETTINGS_MODULE or call settings.configure() before accessing settings.

的错误。尽管代码中已添加了

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'PV_Moniter.settings') django.setup()

但仍报错的根本原因在于：在导入models模块时，Django对应的运行环境尚未初始化完成。

因此，代码的导入顺序至关重要。

正确导入顺序示例


import os
import django
 
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'PV_Moniter.settings')
django.setup()
 
from pv_server.models import IVCurvesInfo, FaultType

调整导入顺序后，问题即可顺利解决。

以上关于在脚本中单独使用Django ORM模型的详解内容，旨在提供实用参考，欢迎支持。