Django模型导入失败：import错误及配置问题求助

问题场景 #

在Django项目的myapp应用中，尝试从同目录的store.py导入models.py里的Radio模型，多次导入尝试均失败，具体尝试方式及对应报错如下：

• A) 相对导入：from . import models，报错：ImportError: attempted relative import with no known parent package
• B) 绝对导入：from myapp.models import Radio，报错：ModuleNotFoundError: No module named 'myapp'
• C) 相对导入：from .models import Radio，报错：ImportError: attempted relative import with no known parent package
• D) 直接导入：from models import Radio，报错：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.

已知前置配置：

• 模型已执行manage.py makemigrations && manage.py migrate
• myapp已在settings.py的INSTALLED_APPS中配置为'myapp.apps.MyappConfig'

项目目录结构：

├── base
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── myapp
│   ├── __init__.py
│   ├── __pycache__
│   ├── admin.py
│   ├── apps.py
│   ├── fetch.py
│   ├── migrations
│   │   ├── 0001_initial.py
│   │   ├── __init__.py
│   ├── models.py
│   ├── scripts
│   ├── static
│   │   └── myapp
│   │       └── home.css
│   ├── store.py
│   ├── templates
│   │   └── myapp
│   │       └── home.html
│   ├── tests.py
│   ├── urls.py
│   └── views.py
├── db.sqlite3
├── manage.py
├── output.txt
└── main.py

报错原因分析 #

所有报错的核心原因集中在两点：

1. 相对导入失败：直接运行store.py时，Python将其视为顶层脚本文件，无法识别它属于myapp包，因此相对导入找不到父包。
2. 绝对导入/直接导入失败：
   • 绝对导入找不到myapp是因为项目根目录未加入Python的sys.path，Python无法定位到myapp模块。
   • 直接导入models触发Django配置错误，是因为导入模型会自动触发Django的settings检查，此时未初始化Django环境，导致配置未加载。

解决方案 #

1. 选择正确的导入语句 #

在store.py中，以下两种导入方式均有效，前提是运行方式正确：

• 相对导入（同应用内推荐使用，灵活性更高）：

  from .models import Radio
  

• 绝对导入：

  from myapp.models import Radio
  

2. 采用合规的运行方式 #

禁止直接运行store.py，必须通过Django的环境上下文来执行，以下是三种可行方式：

方式一：通过django-extensions的runscript运行

利用Django扩展工具的脚本运行功能，自动初始化环境：

1. 安装依赖：

   pip install django-extensions
   

2. 在settings.py的INSTALLED_APPS中添加：

   INSTALLED_APPS = [
       # ... 其他应用
       'django_extensions',
   ]
   

3. 将store.py移动到myapp/scripts/目录下（已有该目录），然后执行：

   python manage.py runscript store
   

方式二：手动初始化Django环境

如果必须直接运行store.py，需在文件开头先初始化Django配置：

import os
import django

# 设置Django配置模块路径
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'base.settings')
# 初始化Django环境
django.setup()

# 初始化完成后再导入模型
from myapp.models import Radio

方式三：作为应用组件被调用

如果store.py是被views.py、admin.py等Django原生组件调用的，直接使用相对/绝对导入即可——这些组件运行时Django环境已自动初始化，不会触发配置错误。

3. 验证项目根目录的sys.path配置 #

若绝对导入仍报错，可在store.py开头添加代码检查sys.path：

import sys
print(sys.path)

确保包含manage.py的项目根目录在列表中。如果不在，可手动添加：

import sys
import os
# 将项目根目录加入sys.path
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

但更推荐使用前两种方式，避免手动修改sys.path带来的维护问题。

内容的提问来源于stack exchange，提问作者user2803490