Django配置路由from . import views报无已知父包相对导入错误解决方法

算力阿峰

2026-8-27

错误原因

from . import views属于Python的相对导入语法，.代表当前文件所属的父包，抛出attempted relative import with no known parent package错误的核心原因是：Python解释器无法识别当前编写路由的urls.py文件所属的父包，自然无法通过相对路径定位同目录下的views模块。
常见触发场景包括：

直接单独运行urls.py文件，而非通过Django的manage.py启动整个项目，此时Python会将urls.py所在目录识别为顶层目录，不存在上层包结构
对应App未在项目settings.py的INSTALLED_APPS中注册，Django加载路由时无法识别App的包结构
App目录下缺少__init__.py空文件，Python不会将无该文件的目录识别为可导入的包
项目路径配置错误，比如BASE_DIR配置偏差、根路由引用urls文件时路径写错，导致Python的模块搜索路径找不到对应父包

排查修复步骤

按照以下顺序逐一排查即可解决问题：

修正启动方式

禁止直接右键单独运行urls.py、views.py这类App内部文件，所有项目启动操作都要切换到manage.py所在的项目根目录，执行python manage.py runserver命令启动服务。单文件运行时不存在完整的项目包结构，必然触发相对导入错误。

校验App目录结构
确认你编写路由代码对应的App目录下存在空的__init__.py文件，标准App目录结构参考如下：

your_app/  # 替换为你自己的App名称
├── __init__.py  # 必须存在，空文件即可，作用是标识当前目录为Python可导入包
├── admin.py
├── apps.py
├── models.py
├── views.py
├── urls.py  # 你编写上述路由代码的文件
└── migrations/
    └── __init__.py

确认App已正确注册
打开项目配置目录下的settings.py，找到INSTALLED_APPS列表，将你的App名称添加到列表中，示例：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'your_app',  # 替换为你自己的App名称
]

检查根路由引用配置
打开与settings.py同目录的项目根路由文件urls.py，确认通过include引入App路由时路径正确，示例：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('your_app.urls')),  # 替换为你自己的App名称
]

兜底验证方案
如果以上配置检查完仍报错，可以先把相对导入改为绝对导入验证包路径是否通畅：将from . import views替换为from your_app import views（替换为你自己的App名）。如果修改后可以正常运行，说明包路径识别仍有问题，返回前几步重新核对目录结构、注册配置即可。

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