在 Django 中，模板引擎只支持特定的数据类型（如字典、QuerySet 等）作为上下文数据传递给模板。如果视图函数返回的是列表，而不是字典或其他兼容数据类型，模板将无法正确读取数据。这是因为模板上下文需要是一个可用变量名称进行引用的键值对，而列表无法满足这个条件。

---

原因分析

1. 模板上下文必须是字典

• Django 模板引擎需要通过变量名称（键）引用上下文数据，而列表没有键值对结构。
• 如果你返回的是一个列表，例如：
  python return render(request, 'template.html', [1, 2, 3])
  这将导致 Django 抛出异常：
  TypeError: context must be a dict rather than list.

1. 数据未绑定到变量

• 模板引擎会尝试使用上下文中的变量，例如 {{ my_list }}。如果上下文是列表，模板中无法找到名为 my_list 的变量。

---

解决方法

方法 1：将列表包装到字典中

将列表作为字典的值传递给模板，例如：

def my_view(request):
    my_list = [1, 2, 3]
    return render(request, 'template.html', {'my_list': my_list})

模板中可以通过 {{ my_list }} 引用列表，并进行遍历：

<ul>
    {% for item in my_list %}
        <li>{{ item }}</li>
    {% endfor %}
</ul>

---

方法 2：直接返回 QuerySet

如果列表来源于数据库查询，建议直接返回 QuerySet，因为 QuerySet 是字典兼容的，可以直接传递给模板：

from .models import MyModel

def my_view(request):
    queryset = MyModel.objects.all()
    return render(request, 'template.html', {'queryset': queryset})

模板中使用：

<ul>
    {% for obj in queryset %}
        <li>{{ obj.name }}</li>
    {% endfor %}
</ul>

---

方法 3：为列表创建变量名称（自定义）

如果你真的需要直接返回列表，必须通过自定义 HttpResponse 返回一个自定义渲染的 HTML 内容（不推荐）：

from django.http import HttpResponse
from django.template import Template, Context

def my_view(request):
    my_list = [1, 2, 3]
    template = Template("""
    <ul>
        {% for item in my_list %}
            <li>{{ item }}</li>
        {% endfor %}
    </ul>
    """)
    context = Context({'my_list': my_list})
    return HttpResponse(template.render(context))

---

总结

模板无法读取列表是因为 Django 模板引擎的上下文需要是字典结构。最常见的解决方法是将列表封装到字典中并通过键访问。始终优先使用 render 和字典来传递上下文数据，以便保持代码的可读性和一致性。