在 Django 中，render() 函数只接受一个上下文字典作为上下文参数，不能传入多个字典；将多个字典分开传入会导致错误或后一个被忽略。

在 django 中，`render()` 函数只接受一个上下文字典作为上下文参数，不能传入多个字典；将多个字典分开传入会导致错误或后一个被忽略。

在开发电商网站时，首页（index.html）通常需要同时展示商品列表（Product）和分类导航（Category）。你当前的视图代码试图通过两次定义字典并分别传入 render() 来实现：

def index(request):
    products = Product.objects.all()
    params = {'product': products}

    categories = Category.objects.all()
    category = {'category': categories}

    return render(request, 'index.html', params, category)  # ❌ 错误！render 不支持多个字典参数

这段代码会引发 TypeError: render() takes 3 positional arguments but 4 were given（Django 4.x+）或静默覆盖（旧版本），因为 render(request, template, context) 的第三个参数 必须是单个字典，多余参数会被拒绝。

✅ 正确做法是：将所有上下文数据合并到一个字典中再统一传入：

def index(request):
    products = Product.objects.all()
    categories = Category.objects.all()

    context = {
        'products': products,   # 推荐使用复数名，语义更清晰
        'categories': categories
    }
    return render(request, 'index.html', context)  # ✅ 正确：仅传入一个字典

? 小贴士：

• 字典键名（如 'products'）将在模板中作为变量名使用，建议使用语义化、易读的名称；
• 避免键名冲突（如两个变量都叫 'data'），也避免使用 Python 关键字（如 'list', 'object'）；
• 可结合 get_context_data()（在基于类的视图中）或 |default 模板过滤器增强健壮性，例如 {{ products|default:'暂无商品' }}。

在 index.html 中即可安全使用：

<!-- 显示分类导航 -->

{% for cat in categories %}
• {{ cat.name }}
{% endfor %}

{% for prod in products %}

{{ prod.name }}

{{ prod.price }} 元

{% endfor %}

⚠️ 注意事项：

• 不要尝试用 **params, **category 解包方式拼接（虽语法可行，但不必要且易出错）；
• 若上下文逻辑复杂，可封装为函数（如 get_index_context()）提升可读性与复用性；
• 开发阶段建议开启 DEBUG=True 并关注终端报错信息——Django 会明确提示 render() 参数错误类型。

掌握单字典上下文传递原则，是构建可维护 Django 模板系统的基础一步。