在Django项目开发过程中，类视图凭借其封装性好、复用性强的特点，成为处理业务请求的主流选择。当业务场景需要向模板传递多个不同类型的数据时，比如同时传递查询结果列表、分页信息、用户权限标识等多值数据，需要遵循Django的传值规范才能保证模板正确渲染。
Django类视图传值的核心机制
Django类视图向模板传递数据的核心逻辑是，将所有需要在模板中使用的数据整理到上下文（context）字典中，模板渲染时会从该字典里读取对应的变量。最标准的传值方式是重写类视图的get_context_data方法，该方法原本的作用就是构建上下文数据，对其进行扩展就能添加自定义的多值数据。
重写get_context_data传递多值数据
以常见的ListView为例，假设需要同时向模板传递文章列表、分类列表、当前页面的页码三个数据，代码实现如下：
from django.views.generic import ListView
from .models import Article,Category
class ArticleListView(ListView):
model = Article
template_name = 'article_list.html'
context_object_name = 'article_list'
paginate_by = 10 # 每页显示10条数据
def get_context_data(self,**kwargs):
# 先调用父类方法获取默认的上下文数据，比如分页相关的对象
context = super().get_context_data(**kwargs)
# 添加自定义的多值数据
context['category_list'] = Category.objects.all() # 全部分类列表
context['current_page'] = self.request.GET.get('page',1) # 当前页码
context['page_title'] = '文章列表页' # 页面标题
return context
上述代码中，父类get_context_data已经自动添加了article_list（查询结果）、page_obj（分页对象）等默认数据，我们通过扩展上下文字典，额外添加了三个自定义数据，模板中可以直接使用这些变量。
直接控制响应传递多值数据
如果类视图的逻辑比较简单，不需要依赖通用类视图的默认行为，也可以重写get或post方法，手动构造上下文并返回渲染响应：
from django.shortcuts import render
from django.views import View
from .models import User,Order
class UserDashboardView(View):
def get(self,request,user_id):
# 查询多个维度的数据
user_info = User.objects.get(id=user_id)
recent_orders = Order.objects.filter(user_id=user_id).order_by('-create_time')[:5]
unread_messages = 3 # 假设未读消息数量
# 构造上下文字典，传递多值数据
context = {
'user_info': user_info,
'recent_orders': recent_orders,
'unread_messages': unread_messages
}
return render(request,'user_dashboard.html',context)
多值数据的类型处理注意事项
当传递的多值数据包含复杂类型时，需要注意模板的取值语法：
- 如果传递的是列表数据，模板中可以使用
for循环遍历，比如{% for article in article_list %} - 如果传递的是字典数据，模板中可以通过
字典名.键名的方式取值，比如{{ user_info.nickname }} - 如果传递的是嵌套结构，比如列表里包含字典，取值时需要逐层访问，例如
{{ order_list.0.order_sn }}表示取第一个订单的订单号
常见错误与避坑指南
不要在类视图中直接定义实例变量来存储要传递的数据，因为类视图的实例可能在多次请求中被复用，会导致数据错乱。
另外，如果传递的多个数据中有依赖请求参数的计算结果，需要把相关逻辑放在get_context_data或者请求处理方法中，保证每次请求的数据都是实时计算的。比如当前页码、用户身份相关的数据，都需要基于当前self.request对象获取，避免缓存旧数据。
模板中接收多值数据的示例
对应前面ArticleListView的模板代码可以参考如下写法：
<h1>{{ page_title }}</h1>
<p>当前页码：{{ current_page }}</p>
<h3>文章列表</h3>
<ul>
{% for article in article_list %}
<li>{{ article.title }}</li>
{% endfor %}
</ul>
<h3>分类列表</h3>
<ul>
{% for category in category_list %}
<li>{{ category.name }}</li>
{% endfor %}
</ul>
按照上述方式组织代码，就能保证Django类视图向模板传递多值数据时的正确性和规范性，减少开发过程中的调试成本。