Django ModelAdmin中extra_context传递与模板读取问题

别着急，我之前在定制ModelAdmin模板的时候也踩过这个坑，给你梳理下正确的传递和读取步骤，保证能解决你的问题：

1. 确保admin.py中changeform_view的重写正确 #

你需要在重写方法时，先调用父类的changeform_view获取原始上下文，再把自定义变量合并进去，而不是直接创建新的extra_context。示例代码如下：

from django.contrib import admin
from .models import YourModel

class YourModelAdmin(admin.ModelAdmin):
    # 指定自定义模板路径
    change_form_template = 'admin/your_app/change_form_htmx.html'

    def changeform_view(self, request, object_id=None, form_url='', extra_context=None):
        # 初始化extra_context为空字典，避免父类传递的上下文为None
        extra_context = extra_context or {}
        # 添加你的自定义变量
        extra_context['myvar'] = "这是我要传递的自定义内容"
        # 调用父类方法，把合并后的上下文传进去
        return super().changeform_view(
            request, object_id, form_url, extra_context=extra_context
        )

admin.site.register(YourModel, YourModelAdmin)

这里要注意：必须用extra_context = extra_context or {}处理初始值，防止父类传递的上下文为None导致合并失败；同时一定要把合并后的extra_context传给父类方法，不能自己直接返回响应。

2. 自定义模板中正确读取变量 #

你的change_form_htmx.html需要正确继承Django默认的change_form模板，并且在合适的位置使用{{ myvar }}读取变量。示例模板代码：

{% extends "admin/change_form.html" %}

{% block content %}
    <!-- 输出自定义变量 -->
    <div class="custom-info">我的自定义变量内容：{{ myvar }}</div>
    <!-- 保留原有默认内容 -->
    {{ block.super }}
{% endblock %}

常见坑点提醒： #

• 不要忘记继承默认模板：如果你的模板没有继承admin/change_form.html，会丢失上下文传递的链路，导致变量读不到。
• 检查模板路径：确保change_form_template指定的路径和模板文件实际位置一致，比如放在templates/admin/your_app/目录下，Django才能正确找到。
• 清除缓存：有时候Django的模板缓存会导致修改不生效，可以重启服务或者手动清除模板缓存试试。

3. 排查问题：验证上下文是否传递成功 #

如果还是读不到变量，可以在模板中添加调试标签查看所有上下文变量：

{% debug %}

把这个标签加到模板里，就能看到所有可用的上下文变量，确认myvar是否在其中。如果不在，说明admin.py的传递步骤有问题；如果在但显示不出来，可能是模板语法错误或者变量放置的位置不对。

内容的提问来源于stack exchange，提问作者Bino Oetomo