在 Django 模板中动态访问嵌套列表元素：自定义过滤器实现索引计算

本文介绍如何在 django 模板中根据模型字段（如 `week.number`）动态索引二维列表（如 `activity_list[i][j]`），解决模板无法直接执行表达式求值的限制，核心方案是编写并注册自定义模板过滤器。

在 django 模板系统中，变量解析是静态且受限的：你不能写 activity_list.{{ week.number }}.0 或 activity_list.week.number.0 这类语法——Django 不支持运行时表达式求值或链式动态索引。当你拥有一个二维结构（如 activity_list[i][j] 表示第 i 周第 j 天的 Strava 活动），同时在模板中遍历 Plan 关联的周对象（例如 week.number 是一个整数字段），就必须借助可扩展机制来桥接这一鸿沟。

最简洁、符合 Django 设计哲学的解决方案是：编写一个通用的模板过滤器，用于安全地按键/索引访问字典或列表。

✅ 步骤一：创建自定义模板过滤器

在你的应用目录下（如 myapp/），新建 templatetags/list_extras.py（注意：需包含空的 __init__.py 文件使其成为 python 包）：

# myapp/templatetags/list_extras.py from django import template  register = template.Library()  @register.filter def lookup(obj, key):     """     安全地通过 key 访问 obj 的元素（支持 list[int]、dict[key]、object.attr）     若 key 为整数且 obj 是列表/元组，则按索引取值；     若 key 为字符串且 obj 有该属性或键，则返回对应值；     否则返回 None（避免模板崩溃）。     """     try:         if isinstance(key, int) and hasattr(obj, '__getitem__'):             return obj[key]         elif isinstance(key, str):             # 先尝试属性访问（如 obj.sport_display）             if hasattr(obj, key):                 return getattr(obj, key)             # 再尝试字典式键访问             elif isinstance(obj, dict):                 return obj.get(key)         return None     except (IndexError, KeyError, TypeError, ValueError):         return None

? 重要提示：Django 模板中所有变量均为字符串类型，因此若 week.number 是模型字段（如 models.PositiveSmallIntegerField），它在模板中会自动转为 int；但若你传递的是字符串形式（如 “2”），需额外处理。上述 lookup 过滤器已兼容 int 索引访问列表。

✅ 步骤二：在模板中加载并使用过滤器

在你的 .html 模板顶部加载自定义标签库：

{% load list_extras %}

假设你在视图中传递了：

• plan: 当前 Plan 实例
• activity_list: 二维列表，如 [ [act_mon_w1, act_tue_w1], [act_mon_w2, act_tue_w2], … ]

并在模板中按周循环（例如使用 plan.weeks 生成 range）：

{% for week_num in plan.weeks|add:"1"|get_range %}   
Week {{ week_num }}
   {% with week_activities=activity_list|lookup:week_num|default:"[]" %}     {% for day_idx in "0123456"|make_list %}       {% with activity=week_activities|lookup:day_idx %}         {% if activity %}           
Day {{ forloop.counter }}: {{ activity.name }} ({{ activity.distance }} km)
         {% else %}           
Day {{ forloop.counter }}: —
         {% endif %}       {% endwith %}     {% endfor %}   {% endwith %} {% endfor %}

? 提示：get_range 和 make_list 是常见辅助过滤器（可自行实现或使用 django-widget-tweaks 等库），此处仅作示意。核心在于 activity_list|lookup:week_num 动态获取第 week_num 周的活动子列表，再用 |lookup:day_idx 获取当天活动。

⚠️ 注意事项与最佳实践

• 安全性优先：模板中应避免复杂逻辑。所有数据预处理（如将 API 返回的原始活动列表转换为按周/日对齐的二维结构）应在视图或模型方法中完成，而非模板内。
• 性能考量：频繁调用 lookup 过滤器不会显著影响性能，但它不替代合理的数据建模。若 activity_list 结构长期固定，可考虑在 Plan 模型中添加 @Property 方法（如 def weekly_activities(self): …）直接返回加工后的结构，使模板调用更清晰：{{ plan.weekly_activities|lookup:week_num }}。
• 错误防御：本过滤器已内置异常捕获，返回 None 而非抛出异常，确保模板渲染健壮。你可在模板中配合 default 或 default_if_none 过滤器提供兜底内容。
• 不推荐的替代方案：
  ❌ 在视图中拼接字符串键（如 “activity_list[{}][{}]”.format(i,j)）→ 模板无法解析；
  ❌ 使用 with + for 模拟索引 → 代码冗长且不可维护；
  ❌ 修改模型强制扁平化数据 → 违背关注点分离原则。

✅ 总结

Django 模板本身不支持动态索引表达式，但通过轻量级自定义过滤器（如 lookup），你可以安全、清晰、可复用地实现 list[index] 或 dict[key] 的运行时访问。这不仅解决了 activity_list[week.number][0] 类需求，也适用于任何需要模板侧“间接寻址”的场景——从嵌套 API 响应到多维配置映射，皆可优雅应对。记住：模板负责展示，逻辑交给 Python；而过滤器，正是二者之间最得力的胶水。