如何扩展Django Admin模型新增/创建表单的模板？

核心问题说明 #

Django Admin的新增表单并没有独立的admin/add_form.html模板，它默认复用admin/change_form.html，仅通过上下文变量区分新增/修改场景。这就是你继承admin/add_form.html会报错，直接继承change_form.html但修改不生效的原因。

正确实现步骤 #

1. 复用同一模板（推荐） #

如果新增和修改表单的自定义逻辑差异不大，可共用一个模板，通过模板变量区分场景：

• 在ModelAdmin中同时指定两个模板路径为同一文件：

@admin.register(MyModel)
class MyModelAdmin(admin.ModelAdmin):
    # 其他Admin配置...
    change_form_template = "admin/some_custom_form.html"
    add_form_template = "admin/some_custom_form.html"

• 自定义模板app/templates/admin/some_custom_form.html中，用is_add变量判断场景：

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

{% block content %}
    {% if is_add %}
        <p>新增页面专属自定义内容</p>
    {% else %}
        <p>修改页面专属自定义内容</p>
    {% endif %}
    {{ block.super }}  <!-- 保留原Admin表单的核心内容 -->
{% endblock %}

2. 分开独立模板（按需使用） #

如果必须分开两个模板，新增模板仍需继承admin/change_form.html，再针对新增场景做定制：

• ModelAdmin配置：

@admin.register(MyModel)
class MyModelAdmin(admin.ModelAdmin):
    # 其他Admin配置...
    change_form_template = "admin/some_custom_change_form.html"
    add_form_template = "admin/some_custom_add_form.html"

• 新增模板app/templates/admin/some_custom_add_form.html：

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

{% block content %}
    <p>新增页面专属内容</p>
    {{ block.super }}
{% endblock %}

关键原理补充 #

Django Admin的新增表单视图（add_view）默认使用的模板就是change_form.html，仅会传入额外上下文变量is_add=True。官方定义中，add_form_template若未指定，会直接复用change_form_template的配置，而后者默认值为admin/change_form.html。

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