本文介绍如何在 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 模板顶部加载自定义标签库：
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
{% 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 %}
<h3>Week {{ week_num }}</h3>
{% 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 %}
<div>Day {{ forloop.counter }}: {{ activity.name }} ({{ activity.distance }} km)</div>
{% else %}
<div>Day {{ forloop.counter }}: —</div>
{% 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；而过滤器，正是二者之间最得力的胶水。
