Django模板遍历嵌套列表技巧

在 Django 模板中无法直接用变量动态索引嵌套列表（如 `list.{{i}}.{{j}}`），因其点号语法仅支持静态属性或键名访问；本文提供了一种安全、简洁且符合 Django 哲学的解决方案：通过自定义 `get_item` 模板过滤器实现链式动态索引，既能优雅访问 `activity_list[i][j]` 这类结构，又内置异常防护避免渲染崩溃，同时兼顾可读性与复用性——对于需灵活处理动态多维数据的场景，这比视图层预处理更轻量、更通用，是 Django 开发者值得掌握的实用技巧。

在 Django 模板中无法直接使用变量作为索引（如 `activity_list.week.number.0`）访问多维列表，需通过自定义模板过滤器实现动态索引访问。

要在 Django 模板中根据 Plan 模型中的 week.number（假设你已在视图中为每周生成了带序号的 week 对象，例如通过 enumerate() 或自定义 Week 数据类）动态访问 activity_list[i][j]，核心难点在于：Django 模板语言不支持变量索引语法（如 list.{{ i }}.{{ j }}），且点号（.）访问符仅支持字典键或属性名的静态解析，不会对中间变量求值。

✅ 正确解法是编写一个轻量级自定义模板过滤器，用于安全地执行索引操作：

1. 创建自定义过滤器（推荐放在 templatetags/list_extras.py）：

# myapp/templatetags/list_extras.py
from django import template

register = template.Library()

@register.filter
def get_item(container, key):
    """
    安全获取容器中指定键/索引的值。
    支持 list[int], tuple[int], dict[key], 以及链式调用（配合多次 |get_item）
    """
    try:
        return container[key]
    except (KeyError, TypeError, IndexError, ValueError):
        return None

⚠️ 注意：确保已将该应用添加到 INSTALLED_APPS，并在模板顶部加载标签：{% load list_extras %}

2. 在模板中使用（假设 activity_list 是二维列表，week.number 是当前周索引）：

{% load list_extras %}

{% for week in plan.weeks_with_numbers %}  {# 如 [[0, 'Week 1'], [1, 'Week 2']] #}
  <h3>Week {{ week.1 }}</h3>
  {% with day0=activity_list|get_item:week.0|get_item:0 %}
    {% if day0 %}
      <p>Monday activity: {{ day0.name }} ({{ day0.distance }} km)</p>
    {% else %}
      <p>No activity on Monday</p>
    {% endif %}
  {% endwith %}

  {% with wednesday=activity_list|get_item:week.0|get_item:2 %}
    <p>Wednesday: {{ wednesday|default:"— " }}</p>
  {% endwith %}
{% endfor %}

? 关键说明：

• activity_list|get_item:week.0 先取第 i 周的子列表；
• 再对其结果 |get_item:0 取该周第 0 天（周一）的活动对象；
• 过滤器链式调用天然支持嵌套结构，语义清晰、无副作用；
• 异常捕获确保模板渲染健壮，避免因越界或空值导致 500 错误。

? 进阶建议（可选重构）：
若频繁进行此类操作，更优雅的方式是在视图层预处理数据，将 activity_list 转换为与 Plan 语义对齐的结构：

# views.py
context['plan_schedule'] = [
    {
        'week_number': i,
        'days': activities_for_week  # 即 activity_list[i]
    }
    for i in range(plan.weeks)
]

然后模板中可直接使用 schedule.days.0 —— 但此方式牺牲了灵活性。对于 API 动态数据，自定义过滤器仍是最简洁、复用性最强的标准实践。

总结：不要尝试用 . 拼接变量索引，而应拥抱 Django 的过滤器机制——它专为这类模板逻辑扩展而设计，安全、清晰、符合框架哲学。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~