{"title":"How to override templates","version":"4.1","locale":"zh-hans","docname":"howto/overriding-templates","url":"/zh-hans/4.1/howto/overriding-templates/","canonical":"https://djangodocs.dev/zh-hans/4.1/howto/overriding-templates/","summary":"在项目中，你可以想要在另一个 Django 应用中重写模板，不论它是第三方应用或 contrib 应用，例如 django.contrib.admin 。你可以将重写的模板置于工程的模板目录或应用的模板目录。 若应用和工程的模板模板都包含被重写的模板，默认的 Django…","html":"

How to override templatesLink to this heading#

\n

在项目中，你可以想要在另一个 Django 应用中重写模板，不论它是第三方应用或 contrib 应用，例如 django.contrib.admin。你可以将重写的模板置于工程的模板目录或应用的模板目录。

\n

若应用和工程的模板模板都包含被重写的模板，默认的 Django 模板加载器会先尝试加载工程目录下的模板。换句话说，先查找 DIRS，其次 APP_DIRS。

\n\n
\n

重写来自工程目录的模板Link to this heading#

\n

首先，我们探索用在工程模板目录创建替代模板的方法。

\n

假设你正在重写第三方应用 blog 的模板，该应用提供了 blog/post.html 和 blog/list.html 模板。工程关键配置如下:

\n
Code
from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nINSTALLED_APPS = [\n    ...,\n    'blog',\n    ...,\n]\n\nTEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [BASE_DIR / 'templates'],\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

若用模板工程模板创建工程，则 TEMPLATES 和 BASE_DIR 早已存在。需要修改的配置是 DIRS。

\n

这些配置假定在工程根目录下有个 templates 目录。要重写 blog 应用的模板，在 templates 目录中创建一个文件夹，然后将以下模板文件添加至该目录：

\n
None
templates/\n    blog/\n        list.html\n        post.html\n
\n

模板加载器会先查找 DIRS 目录下的模板。当 blog 应用中的视图要求 blog/post.html 和 blog/list.html 模板，加载器会返回你刚创建的文件。

\n
\n
\n

重写来自应用模板目录的模板Link to this heading#

\n

由于重写的模板位于工程应用之外，更常见的做法是使用第一个方法，然后将重写的模板置于工程模板目录。然而，如果你偏爱将重写的模板放入应用模板目录，也是可以的。

\n

首先，确保模板配置会搜索应用模板目录:

\n
Code
TEMPLATES = [\n    {\n        ...,\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

若你想重写名为 blog/list.html 和 blog/post.html 的模板，并将它们置于名为 myapp 的应用中，那么目录结构应该看起来像这样：

\n
None
myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n
\n

当 APP_DIRS 置为 True 时，模板加载器会深入应用的模板目录查找模板。

\n
\n
\n

扩展复写模板Link to this heading#

\n

当你配置好你的模板加载器后，你可以使用 {% extends %} 模板标签的同时来覆盖它。这样可以让你不用重写整个模板就可以做一些微小的改动。

\n

举个例子，你可以使用这项技术在 admin/base_site.html 管理员模板中添加自定义的Logo：

\n
\n
templates/admin/base_site.html
\n
Django template
 {% extends "admin/base_site.html" %}\n\n {% block branding %}\n     <img src="link/to/logo.png" alt="logo">\n     {{ block.super }}\n {% endblock %}\n
\n
\n

关键注意点：

\n\n

这个技术起作用是因为当解析到 extends 标签时模板加载器不认为这是已经加载过的有覆盖的模板（管理员模板位于 templates/admin/base_site.html）。与 block.super 的结合是对原有内容做很小的改动的有力技术。

\n
","rootId":"how-to-override-templates","toc":[{"title":"重写来自工程目录的模板","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"重写来自应用模板目录的模板","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"扩展复写模板","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"操作指南","url":"/zh-hans/4.1/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"How to create PDF files","url":"/zh-hans/4.1/howto/outputting-pdf/"},"next":{"docname":"howto/static-files/index","title":"How to manage static files (e.g. images, JavaScript, CSS)","url":"/zh-hans/4.1/howto/static-files/"},"formats":{"html":"/zh-hans/4.1/howto/overriding-templates/","markdown":"/zh-hans/4.1/howto/overriding-templates.md","json":"/zh-hans/4.1/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/4.1.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/zh-hans/4.1/howto/overriding-templates/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}