Django模板自定义标签定义的变量无法在for循环外访问如何解决？

问题原因 #

Django模板的for循环拥有独立的局部作用域，你在循环内部通过as语法赋值的变量默认仅在循环作用域内生效，出了循环就会失效。另外你代码里还存在笔误：自定义标签命名为setvar，模板中调用时写为了setvalor，这也会导致赋值不生效。

解决方案 #

方案1：修改自定义标签，直接写入顶层上下文 #

修改你的自定义模板标签，开启上下文传递，直接把变量写入全局上下文，避开局部作用域限制：

@register.simple_tag(takes_context=True)
def setvar(context, key, val=None):
    # 直接修改上下文最顶层的字典，跳过局部作用域
    context.dicts[0][key] = val
    return ''

模板中使用方式如下：

<div>
    <!-- 先在循环外初始化变量，避免条件不触发时变量不存在 -->
    {% setvar 'has_favorites' '0' %}
    {% for item in items %}
        {% if <!-- condition --> %}
            {% setvar 'has_favorites' '1' %}
        {% endif %}
    {% endfor %}
    <div>{{ has_favorites }}</div>
</div>

方案2：利用可变对象绕开作用域限制 #

如果不想修改自定义标签，可以利用列表这类可变对象的特性，修改对象内容不会触发变量重新赋值，也就不受局部作用域限制：

<div>
    <!-- 初始化一个只有一个元素的列表，初始值为0 -->
    {% with has_favorites='0'|make_list %}
        {% for item in items %}
            {% if <!-- condition --> %}
                <!-- 直接修改列表的第一个元素，不需要重新赋值变量 -->
                {% setvar '1' as has_favorites.0 %}
            {% endif %}
        {% endfor %}
        <div>{{ has_favorites.0 }}</div>
    {% endwith %}
</div>

方案3：把逻辑迁移到视图中（最佳实践） #

模板的定位是处理渲染逻辑，这类数据判断逻辑更适合放在视图里处理，性能更好，也更易维护：

# 视图代码
def your_view(request):
    items = YourModel.objects.all()
    has_favorites = any(<!-- 你的判断条件 --> for item in items)
    return render(request, 'your_template.html', {'items': items, 'has_favorites': has_favorites})

模板里直接调用变量即可：

<div>
    {% for item in items %}
        <!-- 循环渲染逻辑 -->
    {% endfor %}
    <div>{{ has_favorites }}</div>
</div>

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