模板继承base.html时，<!DOCTYPE html>标签是否会被自动继承？

核心结论 #

• 父模板（base.html）中的<!DOCTYPE html>会被完整传递到最终渲染后的页面，不需要在子模板（home.html）中重复声明。
• 绝对不能在子模板的{% extends 'base.html' %}标签前添加任何内容（包括<!DOCTYPE html>、空格甚至空行），这会导致Django模板继承失效，因为extends必须是子模板的第一个有效代码。

具体说明 #

当你使用{% extends %}进行模板继承时，Django的处理逻辑是：

1. 加载父模板的完整结构（包括<!DOCTYPE html>、<html>、<head>等头部代码）
2. 将子模板中定义的{% block %}内容替换到父模板对应的块位置
3. 最终输出的是父模板框架+子模板填充内容的完整HTML页面

正确示例 #

• 父模板base.html（部分代码）：

<!DOCTYPE html>
<html lang="en">  
<head>      
    <meta charset="UTF-8">
    {% block head %}{% endblock %}
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

• 子模板home.html：

{% extends 'base.html' %}

{% block head %}
    <title>首页</title>
{% endblock %}

{% block content %}
    <h1>欢迎访问首页</h1>
{% endblock %}

渲染后生成的HTML会自动包含父模板的<!DOCTYPE html>，不需要在子模板中额外添加。

错误示例 #

不要像下面这样写子模板，这会导致继承异常：

<!DOCTYPE html>

{% extends 'base.html' %}

这种写法会让Django无法正确识别继承关系，最终输出的页面可能会包含重复的DOCTYPE，甚至出现结构混乱。

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