Django导入自定义应用时出现Unresolved reference问题求助

问题场景 #

导入自定义Django应用new_app及其中的some_page视图时，出现**Unresolved reference（未解析引用）**错误，已在settings.py的INSTALLED_APPS中注册该应用：

settings.py相关代码：

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'new_app'
]

new_app/views.py代码：

from django.shortcuts import render
from django.http import HttpResponse


def some_page(request):
    return HttpResponse('Hello world')

排查及解决步骤 #

• 检查应用目录结构
  确保new_app是标准Django应用结构，必须包含空的__init__.py文件，Python才能识别它为可导入模块。目录结构示例：

  你的项目名/
  ├── 你的项目名/
  │   ├── settings.py
  │   └── ...
  ├── new_app/
  │   ├── __init__.py
  │   ├── views.py
  │   └── ...
  └── manage.py
  

  若缺少__init__.py，直接创建空文件即可。

• 刷新IDE缓存与解释器配置
  这类错误常是IDE缓存或解释器配置问题：

  1. 确认IDE选中了项目对应的虚拟环境Python解释器
  2. 刷新IDE缓存（比如PyCharm按Ctrl+Shift+F9重新加载项目，VS Code按Ctrl+Shift+P执行"Python: Reload Window"）

• 验证导入语法正确性
  在其他文件（如项目urls.py）中导入some_page时，确保路径正确：

  from new_app.views import some_page
  

  优先使用绝对导入，避免相对导入引发的路径混乱。

• 检查Django应用加载状态
  运行python manage.py check命令，若命令无报错，说明应用已被Django正确识别，错误仅为IDE提示问题。

内容的提问来源于stack exchange，提问作者Максим