### Django 中正确引用其他 HTML 模板的方法 在 Django 的模板系统中，可以通过多种方式实现对其他 HTML 模板的引用。这不仅有助于减少重复代码，还能提高项目的可维护性和一致性。 #### 使用 `{% include %}` 标签 `{% include %}` 是一种简单的方式，用于在一个模板中嵌入另一个模板的内容。这种方式适用于需要多次重用的小型片段，比如导航栏、页脚等。以下是具体用法： ```django <!-- base.html --> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>{% block title %}Default Title{% endblock %}</title> </head> <body> {% include "header.html" %} {% block content %} <!-- 页面主体内容 --> {% endblock %} {% include "footer.html" %} </body> </html> ``` 在这个例子中，`header.html` 和 `footer.html` 是两个独立的模板文件，它们被分别引入到主模板 `base.html` 中[^1]。 --- #### 使用 `{% extends %}` 实现模板继承 模板继承是一种更强大的机制，允许子模板基于父模板构建并覆盖部分内容。这是 Django 推荐的方式来管理复杂的布局结构。 ##### 父模板 (base.html) ```django <!-- base.html --> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>{% block title %}{% endblock %}</title> </head> <body> {% block header %} Default Header Content {% endblock %} {% block content %} <!-- 默认内容 --> {% endblock %} {% block footer %} Default Footer Content {% endblock %} </body> </html> ``` ##### 子模板 (child.html) ```django <!-- child.html --> {% extends "base.html" %} {% block title %} Child Page Title {% endblock %} {% block content %} This is the specific content of the child page. {% endblock %} ``` 在这种情况下，`child.html` 继承自 `base.html` 并替换了其中的部分块（如 `content` 块），从而实现了动态定制化页面的功能[^1]。 --- #### 配置模板路径 为了确保 Django 能够找到这些模板文件，在项目设置 (`settings.py`) 文件中需正确配置 `TEMPLATES` 参数下的 `DIRS` 字段。例如： ```python # settings.py import os BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [os.path.join(BASE_DIR, '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', ], }, }, ] ``` 此配置指定了一个全局的 `templates` 目录作为模板查找路径[^2]。 --- #### 处理静态资源 如果模板中涉及 CSS 或 JavaScript 文件，还需要确保 Django 正确处理静态文件。通常的做法是在 `settings.py` 中启用静态文件支持，并在模板中使用 `{% load static %}` 加载静态资源[^3]。 ```django <!-- example_template.html --> {% load static %} <link rel="stylesheet" href="{% static 'css/styles.css' %}"> <script src="{% static 'js/scripts.js' %}"></script> ``` --- #### 安全注意事项 当模板中包含来自用户的输入时，默认情况下 Django 会对这些数据进行自动转义以防止 XSS 攻击。然而，如果有合法需求展示未转义的 HTML 数据，则可以使用 `safe` 过滤器或 `mark_safe()` 函数[^5]。 ```django {{ user_input|safe }} ``` --- ### 总结 Django 提供了丰富的工具来管理和引用 HTML 模板，包括但不限于 `{% include %}`、`{% extends %}` 和模板路径配置等功能。合理利用这些功能可以帮助开发者高效地构建复杂且一致性的 Web 应用程序。