Django模板与静态文件使用指南

En^_^Joy2026-08-19 11:18

文章目录

  • [一、template 目录](#一、template 目录)
    • [1.1 模板语法基础](#1.1 模板语法基础)
    • [1.2 变量与标签使用](#1.2 变量与标签使用)
    • [1.3 过滤器（默认值、日期格式等）](#1.3 过滤器（默认值、日期格式等）)
    • [1.4 模板继承](#1.4 模板继承)
    • [1.5 jinja2模板](#1.5 jinja2模板)
  • 二、static目录（静态文件）

在Django中，static 和 templates 目录的职责非常明确，理解它们的区别对于构建规范的Django项目至关重要。

一、template 目录

template目录一般用于存放HTML模板文件，Django 模板系统用于将业务逻辑（Python）与展示逻辑（HTML/CSS/JS）分离，通过模板语言动态生成页面内容。其核心特性包括变量替换、标签控制和模板继承

1.1 模板语法基础

setting.py配置

在settings.py 的 TEMPLATES 中添加下面字段，指定模板文件路径

python 复制代码 
TEMPLATES = [
	{
		# ...
		'DIRS': [os.path.join(BASE_DIR, 'template')],
	}
]

模板使用

模板文件一般放在项目的template目录下，在该目录中创建一个index.html文件

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Django模板</title>
</head>
<body>
    <a>Django模板</a>
</body>
</html>

在视图views.py文件中，可以直接返回template 里面的文件

python 复制代码 
from django.shortcuts import render

def index(request):
    # 参数1: 当前的请求  参数2: 模板文件
    return render(request, 'index.html')

1.2 变量与标签使用

如果要将数据传入到index.html中，在index.html中可以使用{``{ data }}接收数据传入变量（运算符两侧必须要有空格），如果涉及循环或条件判断，则可以使用{% tag %}标签

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Django模板</title>
</head>
<body>
		<!-- 变量 -->
    <a>{{ name }}</a>
		<!-- 索引 -->
    <a>{{ books.1 }}</a>
    
    <ul>
		<!-- 标签：遍历读取 -->
        {% for book in books %}
            <li>{{ book }}</li>
        {% endfor %}
    </ul>
    
    
    <!-- 标签：条件判断 -->
	{% if age >10 %}
	    大于10岁
	{% else %}
	    不大于10岁
	{% endif %}
</body>
</html>

接着修改views.py，通过context 将数据传入html中（这里的name是下面传入字典的键，得到的就是下面传入的字典的值Python）

python 复制代码 
from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    # 参数1: 当前的请求   参数2: 模板文件   参数3：context传递参
    return render(request, 'index.html', context={'name': 'Python', 'book': ['aa', 'bb'], 'age': 10})

1.3 过滤器（默认值、日期格式等）

语法：{``{ 变量|过滤器:参数 }}

过滤器 含义
default 默认值 （如果变量不存在时则返回默认值 `date
length 长度 （返回字符丰包含字符的个数，或列表、元组、字典的元素个数）
safe 转义 （返回内容为html当存文本处理，使用转义可转为存文本）
date 日期 （用于对日期类型的值进行字符串格式化 `value
日期格式化字符 含义 解释
Y 年 格式4位（y两位）
m 月 01,02,12
d 日 01,02
j 日 1,2
H 时 24小时制（h12小时制）
i 分 0-59
s 秒 0-59

举例

python 复制代码 
from django.shortcuts import render
from django.views import View
import datetime

class HomeView(View):
    def get(self,request):
        username = request.GET.get('username')
        context = {
            'datetime': datetime.datetime.now(),
        }
        return render(request, 'index.html', context=context)
html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
日期：{{ datetime|date:'Y m d' }}
</body>
</html>

1.4 模板继承

当某些内容在多个页面中公用时，可以使用模板继承的方法，常用于 header 和 footer 部分

父标签

我们可以建立一个基础的文件 base.html，供下方使用，这里使用block标签在父模板中预留区域，在子模板中将其替换填充差异性的内容。预留区域也可以直接填写内容（即默认内容），当子模块未填充的时候，则使用这里的默认内容

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}Title{% endblock title %}</title>
</head>
<body>
{% block header %}
<h1>顶部</h1>
{% endblock header %}

{% block main %}
<h1>主要部分</h1>
{% endblock main %}

{% block footer %}
<h1>底部</h1>
{% endblock footer %}
</body>
</html>

子标签

在子模块中，可以在第一行使用标签extends将父标签导入进来，然后使用 block标签 填写该区域对应的内容。子模版不用填充父模版中的所有预留区域，如果子模版没有填充，则使用父模版定义的默认值

html 复制代码 
{% extends 'base.html' %}

{% block title %}
替换标题
{% endblock title %}

{% block main %}
<a href="">替换主体</a>
{% endblock main %}

{% block footer %}{% endblock %}

1.5 jinja2模板

jinja2是 Python 下的一个被广泛应用的模板引擎，是由Python实现的模板语言，他的设计思想来源于Django的模板引擎，并扩展了其语法和一系列强大的功能，尤其是Flask框架内置的模板语言。由于django默认模板引擎功能不齐全,速度慢，所以我们也可以在Django中使用jinja2，jinja2宣称比django默认模板引擎快10-20倍。Django主流的第三方APP基本上也都同时支持Diango默认模板及inja2，所以要用inia2也不会有多少障碍。
jinja2模板安装 ：pip install jinja2

jiaja2配置：在settings.py中配置

python 复制代码 
TEMPLATES = [
    {
        # 'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # 修改为Jinja2模板
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        'OPTIONS': {
            'environment': 'jinja2.Environment',  # 添加这行  默认的，可加可不加
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },# 如果报错，原始的代码复制到下面
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        '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',
            ],
        },
    },
]

如果还是按之前的方式来使用，这里可能会出现错误

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
日期：{{ datetime|date:'Y m d' }}
</body>
</html>

这是因为jiaja2的语法和上面模板的语法有些区别，区别在于过滤器不同，上面的模板是forloop，jiaja2是loop

jiaja2过滤器

优化后的内容如下

html 复制代码 
<body>
日期：{{ date(datetime) }}
</body>
python 复制代码 
from django.views import View
import datetime

class HomeView(View):
    def get(self,request):
        context = {
            'datetime': datetime.datetime.now(),
        }
        return render(request, 'index.html', context=context)

接着在子应用中创建jinja2_env.py文件，内容如下（否则会显示date未定义）

python 复制代码 
from django.template.defaultfilters import date
from jinja2 import Environment

def environment(**option):
    # 1.创建Environment实例
    env = Environment(**option)
    # 2.指定jinja2的函数指向django的指定过滤器
    env.globals.update({
        'date': date
    })
    # 3.返回Environment实例
    return env

然后修改配置 settings.py，改为调用自己定义的，改完之后就可以正常访问

python 复制代码 
TEMPLATES = [
    {
        # 'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # 修改为Jinja2模板
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        'OPTIONS': {
            # 'environment': 'jinja2.Environment',  # 添加这行  默认的，可加可不加
            'environment': 'book.jinja2_env.environment',  # 指定jinja2的环境
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },# 如果报错，原始的代码复制到下面
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        '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',
            ],
        },
    },
]

要显示特定的格式，在后面和之前一样添加参数

html 复制代码 
<body>

日期：{{ date(datetime,'Y m d') }}
</body>

自定义过滤器

python 复制代码 
from jinja2 import Environment

def environment(**option):
    # 1.创建Environment实例
    env = Environment(**option)
    # 2.将自定义过滤器添加到环境中
    env.filters['do_listreverse'] = do_listreverse
    # 3.返回Environment实例
    return env

# 自定义过滤器
def do_listreverse(li):
    if li == 'B':
        return "abcd"

二、static目录（静态文件）

static 目录一般用于存放静态资源文件，这些是HTML中引用的、不需要动态处理的资源文件。

setting.py 配置

配置 settings.py 文件，指定静态文件所存放路径

python 复制代码 
# Django通过STATIC_UR区分静态资源和动态资源
# 定义模板中引用静态文件时的URL前缀
STATIC_URL = 'static/'
# 指定项目级别的静态文件目录，BASE_DIR变量在该文件上面有定义
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static')
]

如果静态文件目录存在图片，运行时访问http://127.0.0.1:8000/static/1.jpeg就会出现static中的图片

模板文件中引用静态文件

加载static模板标签 ：在html文件顶部加载static模板标签

引用静态文件的路径 ：使用{% static %}模板标签生成完整路径

html 复制代码 
{% load static %}
<!DOCTYPE html>
<html>
<head>
    <link rel="stylesheet" href="{% static 'myapp/css/style.css' %}">
</head>
<body>
    <script src="{% static 'myapp/js/script.js' %}"></script>
</body>
</html>
相关推荐
无凭2 小时前
字节跳动 DeerFlow：Agent Harness 怎么让大模型主动向用户提问？
人工智能·python
蜀道山老天师2 小时前
Python + Playwright 实现问卷星自动化填写
python
Zane19942 小时前
多开几个线程，为什么算数字反而没变快？一文讲透 CPython 的 GIL
后端·python
W_326002 小时前
Python-OpenCV边缘检测与阈值分割：Sobel、Scharr、Laplacian、Canny、全局与自适应阈值
开发语言·图像处理·python·opencv·机器学习
青 春 记 忆3 小时前
LeetCode 121. 买卖股票的最佳时机｜Python 解法详解
python·算法·leetcode
满怀冰雪3 小时前
21-图像分类实战：从 MNIST 到 CIFAR-10
人工智能·python·深度学习·分类·数据挖掘·paddlepaddle
Logintern093 小时前
Celery 的底层架构正是进程池、事件循环、epoll 和协程全部组合在了一起
python·架构·消息队列·进程·celery·事件循环
用户0332126663673 小时前
在 Word 文档快速中插入图片【Python 教程】
python
盖伦发发3 小时前
RAG 能跑≠能用：用 EDD 把 Eval 做成基础设施 (附源码)
人工智能·后端·python·功能测试
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点032026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？04微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新05Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费06历年考研数学一、数学二、数学三真题试卷及答案PDF07AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路08VSCode+CodeX扩展，无法启动092026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片10如何新建文件夹？ 电脑新建文件夹的4种方法