如何修改继承base模板的Django HTML视图文件？修改后不生效如何解决？

问题根因与修复方案 #

1. 模板继承语法错误 #

Django 中使用 {% extends "base.html" %} 的子模板不需要重复定义根级HTML结构，你当前子模板中重复书写了 <!DOCTYPE html>、<html>、<head>、<body> 等base模板已经包含的标签，会导致DOM结构重复、浏览器渲染异常，是页面不更新的核心原因之一。

2. Block块使用逻辑错误 #

你对Django模板块的使用不符合规范：

• 基础模板的 {% block head %} 放在了<head>标签闭合之后的位置，子模板的head块不需要再套一层<html>、<head>标签，只需要放你要新增的head内容（比如标题、自定义CSS等）即可。
• 子模板的 {% block body %} 内部不需要再嵌套<body>标签，直接写你要插入的页面内容即可。
• 你当前子模板的body块声明多了多余空格 {% block body %}，建议修正为 {% block body %} 避免语法识别异常。

修正后的子模板参考代码 #

{% extends "base.html" %}

{% block head %}
<title>Test Project</title>
<!-- 如果有自定义CSS也可以放在这里 -->
{% endblock %}

{% block body %}
<h1 style="font-size: 250px"> Testing </h1>
<p> aloha </p>
<form method="POST">
  {% csrf_token %}
  {{ form.as_p }}
  <input type="submit">
</form>
{% endblock %}

3. 模板不更新的其他排查方向 #

如果修改后页面仍然没有更新，按以下顺序排查：

• 强制刷新浏览器缓存（Windows按Ctrl+F5，Mac按Shift+Command+R），排除本地缓存问题
• 检查Django项目配置文件settings.py中 DEBUG = True 是否开启，调试模式下Django会自动重载修改后的模板，生产模式会缓存模板
• 检查settings.py中的TEMPLATES配置项的DIRS路径，确认你修改的子模板是Django实际加载路径下的文件，避免修改了其他目录下的重名文件

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