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

时间：2026-07-15 20:33:59 编辑：袖梨来源：一聚教程网

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'

5. 启动开发服务器并访问正确URL

python manage.py runserver

然后在浏览器中打开：
? http://127.0.0.1:8000/frontpage/（注意末尾斜杠，与URL配置一致）

❌ 错误方式：双击 frontpage.html 打开（file:///...）、或用 Live Server 插件直接预览——这些绕过Django，必然显示原始模板语法。

? 快速自查清单

[ ] python manage.py runserver 已运行且无报错
[ ] 访问的是 http://127.0.0.1:8000/xxx/，而非本地文件路径
[ ] render() 函数第二个参数是字符串路径（如 'core/frontpage.html'），不是文件系统绝对路径
[ ] base.html 中已定义 content 块，且 frontpage.html 中有对应 {% block content %}
[ ] TEMPLATES['DIRS'] 或 APP_DIRS=True 能正确定位到 templates/core/

遵循以上步骤，Django将完整解析模板继承与块替换，{% block %} 再也不会以源码形式暴露在页面上。

推荐专题

最新下载

热门教程

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

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

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

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

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

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

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

5. 启动开发服务器并访问正确URL

? 快速自查清单

相关文章

热门栏目

php教程

asp.net教程

手机开发

css教程

网页制作

办公数码

jsp教程