Django为何在错误目录查找模板？默认模板路径问题排查

我原本以为Django默认会在myApp/templates/myApp/目录中查找模板，但实际我的项目里它却在myApp/templates/目录中查找，而且没法强制修改这个查找目录。之前的其他项目都正常运行，怀疑是不是Django 4.2.1的文档有更新。

我的项目目录结构：项目根目录下包含配置目录django_project和应用目录school，school目录内有templates文件夹。

相关代码 #

项目配置文件（settings.py） #

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

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'django_project.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

school应用的urls.py #

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
]

项目根目录的urls.py（django_project/urls.py） #

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('school.urls')),
]

school应用的views.py #

from django.shortcuts import render

def home(request):
    return render(request, 'home.html')

问题解答 #

Django默认模板查找逻辑是：当TEMPLATES配置中APP_DIRS=True时，会自动遍历所有已安装应用的templates目录查找模板，但不会自动添加应用名作为子目录前缀。所谓的myApp/templates/myApp/是官方推荐的规范，目的是避免不同应用的模板重名冲突，并非Django强制要求的默认查找路径。

你的项目能在school/templates/找到home.html，完全符合默认逻辑——因为视图里写的是render(request, 'home.html')，Django会直接在所有已安装应用的templates目录下匹配文件名。

如果想让Django只在school/templates/school/下查找，有两种可行方案：

1. 按照规范调整目录结构，把home.html移到school/templates/school/，同时视图中修改为render(request, 'school/home.html')
2. 修改TEMPLATES的DIRS配置，指定具体模板路径，示例如下：

# 需要先导入os模块
import os

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'school/templates/school')],
        'APP_DIRS': False,  # 关闭自动查找应用templates目录
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

注：Django 4.2.1的文档并未修改这一逻辑，官方始终推荐使用应用名/templates/应用名/的结构来避免模板冲突，这是最佳实践而非强制规则。

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