Django模板中block标签显示为原始代码的解决方法

作者：袖梨 2026-07-15

Django模板中的{% block %}等模板标签未被渲染、直接以明文形式显示在浏览器中，根本原因是HTML文件被浏览器直接打开（如通过file://协议），而非经Django服务器解析；必须通过render()视图函数由Django模板引擎处理才能生效。

django模板中的`{% block %}`等模板标签未被渲染、直接以明文形式显示在浏览器中，根本原因是html文件被浏览器直接打开（如通过`file://`协议），而非经django服务器解析；必须通过`render()`视图函数由django模板引擎处理才能生效。

问题根源：模板未被Django引擎解析

你看到类似 {% block content %}{% endblock %} 的原始文本，不是语法错误，而是Django根本没有介入渲染。浏览器直接加载 .html 文件时，会将其当作静态HTML处理——所有 {% ... %} 和 {{ ... }} 都是Django专属语法，纯HTML解析器完全忽略它们，原样输出。

✅ 正确流程必须是：
HTTP请求 → Django路由匹配 → 视图调用 render() → 模板引擎解析 {% block %} 等标签 → 返回渲染后的HTML

✅ 正确配置步骤（以你的项目结构为准）

假设你的应用名为 core（根据 templates/core/ 路径推断），请确保以下配置全部正确：

1. 确保 settings.py 中已注册 core 应用并配置模板目录

# settings.pyINSTALLED_APPS = [    # ... 其他应用    'core',  # 确保已添加]TEMPLATES = [    {        'BACKEND': 'django.template.backends.django.DjangoTemplates',        'DIRS': [BASE_DIR / 'templates'],  # 指向顶层 templates 目录        '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',            ],        },    },]

⚠️ 注意：'DIRS': [BASE_DIR / 'templates'] 是关键！它让Django能在项目根目录下的 templates/ 中查找模板（即你当前的 templates/core/base.html）。

2. 修正 urls.py（项目级或应用级）

在项目主 urls.py（如 mysite/urls.py）中包含 core 的URL：

# mysite/urls.pyfrom django.contrib import adminfrom django.urls import path, includeurlpatterns = [    path('admin/', admin.site.urls),    path('frontpage/', include('core.urls')),  # 推荐：将路由集中到 core/urls.py]

并在 core/urls.py 中定义：

# core/urls.pyfrom django.urls import pathfrom . import viewsurlpatterns = [    path('', views.frontpage, name='frontpage'),  # 可访问 http://127.0.0.1:8000/frontpage/]

3. 补充 base.html 中的 content 块（你缺失的关键部分）

你当前的 base.html 只定义了 title 块，但 frontpage.html 继承后未填充 content —— 更重要的是，base.html 必须显式声明 {% block content %}{% endblock %} 才能被子模板覆盖：

<!-- templates/core/base.html --><!DOCTYPE html><html><head>    <title>{% block title %}{% endblock %}Djangochat</title></head><body>    {% block content %}    <!-- 默认内容（可选） -->    <h1>Welcome to DjangoChat</h1>    {% endblock %}</body></html>

<!-- templates/core/frontpage.html -->{% extends 'core/base.html' %}{% block title %}Welcome | {% endblock %}{% block content %}<h2>Front Page</h2><p>This is rendered via Django template engine.</p>{% endblock %}

4. 确保视图函数正确调用 render

# core/views.pyfrom django.shortcuts import renderdef frontpage(request):    return render(request, 'core/frontpage.html')  # ✅ 正确路径：'app_name/template_name.html'