Django模板加载失败求助：路径匹配异常与独立APP模板加载需求

问题描述 #

报错信息：

django.template.loaders.filesystem.Loader: E:\CS\Udemy\Python and Django Full Stack\Django\charity\templates\posts\post_base.html (Source does not exist)

实际模板路径为 charity\posts\templates\post_base.html，需要让Django正确加载独立应用（posts）内的模板。

当前settings.py配置 #

# Build paths inside the project like this: BASE_DIR / 'subdir'.
BASE_DIR = Path(__file__).resolve().parent.parent
TEMPLATES_DIR = os.path.join(BASE_DIR, "templates")
STATIC_DIR = os.path.join(BASE_DIR, "static")
MEDIA_DIR = os.path.join(BASE_DIR, 'media')


# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

ALLOWED_HOSTS = []


# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'accounts',
    'posts',
    'comments',
    'rest_framework',
    'bootstrap4',
    'django.contrib.humanize',
]

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',
    'django.contrib.sessions.middleware.SessionMiddleware',
    # 'django_session_timeout.middleware.SessionTimeoutMiddleware',
    # 'charity.middleware.SessionExpiredMiddleware',
]

ROOT_URLCONF = 'charity.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [TEMPLATES_DIR],
        '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',
            ],
        },
    },
]

解决方案 #

1. 调整模板路径或引用方式 #

Django启用APP_DIRS: True时，会自动扫描已安装应用的templates目录，但模板引用路径需要和实际存放结构匹配：

• 方法一：修改模板存放路径
  将post_base.html移动到charity/posts/templates/posts/post_base.html，保持应用内模板的标准结构（app_name/templates/app_name/），之后引用模板时使用posts/post_base.html即可被正确识别。
• 方法二：修改模板引用代码
  如果不想移动文件，直接在视图或模板中引用post_base.html（而非posts/post_base.html），Django会遍历所有已安装应用的templates目录查找该文件。

2. 确认核心配置有效性 #

你的配置中已经满足两个关键条件：

• INSTALLED_APPS已添加posts应用
• TEMPLATES中APP_DIRS设置为True
  这两项是Django加载应用内模板的基础，无需额外修改。

3. 清除模板缓存（可选） #

若修改后仍报错，执行以下命令清除Django模板缓存，确保新路径生效：

python manage.py clearcache

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