Django全局复用模板如何在所有URL中获取指定视图的数据？

你遇到的这个场景，在Django里有两种常用的解决办法，能让全局模板在所有页面都拿到需要的数据：

方法一：自定义上下文处理器 #

上下文处理器的作用是给所有模板的上下文自动注入数据，不管哪个视图渲染页面，都能直接调用这些数据。

具体步骤：

1. 在你的app里新建context_processors.py文件，编写获取消息数的逻辑：

# your_app/context_processors.py
from .models import Message  # 替换成你实际的消息模型

def inbox_message_count(request):
    # 仅为登录用户计算未读消息数，未登录用户显示0
    count = 0
    if request.user.is_authenticated:
        count = Message.objects.filter(recipient=request.user, is_read=False).count()
    return {'inbox_message_count': count}

2. 打开项目的settings.py，找到TEMPLATES配置，将这个处理器添加到context_processors列表中：

TEMPLATES = [
    {
        # 保留其他默认配置
        'OPTIONS': {
            'context_processors': [
                'django.contrib.auth.context_processors.auth',
                'django.template.context_processors.debug',
                # 添加上你刚编写的处理器
                'your_app.context_processors.inbox_message_count',
            ],
        },
    },
]

3. 现在直接在全局模板里使用{{ inbox_message_count }}即可，所有页面都会自动加载这个数据。

方法二：使用包含模板标签 #

如果消息数展示需要独立的模板样式，用包含模板标签更合适，它能把数据和模板片段绑定，调用起来更灵活。

步骤如下：

1. 在你的app里创建templatetags目录（必须包含空的__init__.py文件），然后新建inbox_tags.py：

# your_app/templatetags/inbox_tags.py
from django import template
from ..models import Message

register = template.Library()

@register.inclusion_tag('inbox_count.html')  # 指定要渲染的模板文件
def show_inbox_count(request):
    count = 0
    if request.user.is_authenticated:
        count = Message.objects.filter(recipient=request.user, is_read=False).count()
    return {'count': count}

2. 新建对应的模板片段inbox_count.html，编写展示样式：

<!-- templates/inbox_count.html -->
<div class="inbox-badge">
    未读消息：{{ count }}
</div>

3. 在全局模板里，先加载自定义标签，再调用这个标签：

{% load inbox_tags %}
<!-- 放在需要显示消息数的位置 -->
{% show_inbox_count request %}

这样不管哪个URL页面，只要引入了这个全局模板，就能正确渲染出消息数。

注意事项 #

• 上下文处理器会在每个请求中执行，所以逻辑要尽量简洁，避免编写耗时的查询，防止拖慢页面加载速度。
• 包含模板标签仅在被调用时执行，适合逻辑稍复杂或带有独立样式的场景。

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