Django项目模板中资产统计数值不显示问题排查

单独访问asset_dashboard.html时，是通过asset_dashboard视图将统计数据传入了模板上下文；但用{% include %}把它引入base.html后，渲染base.html的目标视图（比如首页、其他业务页面的视图）并没有把这些统计变量注入上下文，导致模板无法渲染出数值。

方案1：使用Django包含模板标签（Inclusion Tag） #

这是最优雅的实现方式，把资产统计逻辑和模板封装成独立标签，任何页面引用都能自动获取数据。

步骤1：创建模板标签文件 #

在你的应用目录下新建templatetags文件夹（需同时创建空的__init__.py文件，让目录成为Python包），然后创建asset_tags.py：

from django import template
from ..models import Asset

register = template.Library()

@register.inclusion_tag('asset_dashboard.html')
def show_asset_dashboard():
    total_assets_count = Asset.objects.count()
    onsite_assets_count = Asset.objects.filter(status='onsite').count()
    fixed_assets_count = Asset.objects.filter(status='fixed').count()
    booked_assets_count = Asset.objects.filter(status='booked').count()
    
    return {
        'total_assets_count': total_assets_count,
        'onsite_assets_count': onsite_assets_count,
        'fixed_assets_count': fixed_assets_count,
        'booked_assets_count': booked_assets_count,
    }

步骤2：修改base.html的引用方式 #

替换原来的{% include 'asset_dashboard.html' %}：

{% load asset_tags %}
{% show_asset_dashboard %}

之后不管哪个视图渲染base.html，只要加载这个标签就能自动渲染统计数据。

方案2：全局上下文处理器 #

如果多个页面都需要展示这些资产统计数据，可以用上下文处理器把变量全局注入所有模板的上下文。

步骤1：创建上下文处理器 #

在应用目录下创建context_processors.py：

from .models import Asset

def asset_stats(request):
    return {
        'total_assets_count': Asset.objects.count(),
        'onsite_assets_count': Asset.objects.filter(status='onsite').count(),
        'fixed_assets_count': Asset.objects.filter(status='fixed').count(),
        'booked_assets_count': Asset.objects.filter(status='booked').count(),
    }

步骤2：配置settings.py #

在TEMPLATES的OPTIONS['context_processors']中添加该处理器：

TEMPLATES = [
    {
        # 其他配置项
        'OPTIONS': {
            'context_processors': [
                # 默认的上下文处理器
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                # ...其他默认项
                # 添加自定义处理器
                '你的应用名.context_processors.asset_stats',
            ],
        },
    },
]

配置完成后，原有的{% include %}写法无需修改，所有模板都能直接使用这些统计变量。

方案3：在目标视图中手动传递上下文 #

如果只有少数几个视图用到base.html，可以在这些视图里手动添加统计数据到上下文：

def home(request):
    # 其他业务逻辑
    total_assets_count = Asset.objects.count()
    onsite_assets_count = Asset.objects.filter(status='onsite').count()
    fixed_assets_count = Asset.objects.filter(status='fixed').count()
    booked_assets_count = Asset.objects.filter(status='booked').count()
    
    context = {
        # 页面原有变量
        'page_title': '首页',
        # 添加资产统计变量
        'total_assets_count': total_assets_count,
        'onsite_assets_count': onsite_assets_count,
        'fixed_assets_count': fixed_assets_count,
        'booked_assets_count': booked_assets_count,
    }
    return render(request, 'home.html', context)

这种方式适合场景单一的情况，但多个视图重复编写统计逻辑会造成代码冗余，不推荐大规模使用。

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