在Django ImportExportModelAdmin中如何仅下载含字段标题的模板文件

Django 的 ImportExportModelAdmin 所属的 django-import-export 库原生支持下载仅含字段标题的空模板文件，同时也支持自定义表头添加必填标注、帮助文本等拓展需求，具体实现如下：

1 基础实现：下载仅含字段标题的空模板 #

无需复杂改造，框架默认的导入页面自带「下载模板」入口，点击后默认导出仅含表头的空文件。如果需要自定义模板下载入口，也可以通过新增Admin动作实现：

# 1. 定义你的Resource类
from import_export import resources
from .models import 你的模型类

class 自定义Resource(resources.ModelResource):
    class Meta:
        model = 你的模型类
        # 按需指定要包含在模板里的字段
        fields = ('字段1', '字段2', '字段3')

# 2. 在ModelAdmin中新增下载模板动作
from import_export.admin import ImportExportModelAdmin
from django.http import HttpResponse

class 你的模型Admin(ImportExportModelAdmin):
    resource_classes = [自定义Resource]
    actions = ['download_import_template']

    def download_import_template(self, request, queryset):
        # 传入空查询集，导出结果仅保留表头
        dataset = 自定义Resource().export(queryset=你的模型类.objects.none())
        # 以xlsx格式为例，也可替换为csv、xls等格式
        response = HttpResponse(dataset.xlsx, content_type='application/vnd.ms-excel')
        response['Content-Disposition'] = 'attachment; filename="导入模板.xlsx"'
        return response
    download_import_template.short_description = "下载导入模板（仅表头）"

2 进阶实现：表头添加必填标注、帮助文本 #

如果需要在表头中展示字段说明、必填标识等信息，可以通过自定义column_name实现，还支持批量读取模型字段属性自动生成标注：

class 自定义Resource(resources.ModelResource):
    class Meta:
        model = 你的模型类
        fields = ('字段1', '字段2', '字段3')

    def __init__(self):
        super().__init__()
        # 批量为所有字段添加标注
        for field_name, field in self.fields.items():
            model_field = 你的模型类._meta.get_field(field_name)
            # 拼接字段显示名、必填标识、帮助文本
            col_name = model_field.verbose_name
            if not model_field.blank:
                col_name += "（必填）"
            if model_field.help_text:
                col_name += f"（{model_field.help_text}）"
            field.column_name = col_name

配置后导出的模板表头会自动包含所有标注，完全匹配需求效果。如果需要额外添加填写说明行，也可以直接操作导出的dataset对象插入自定义行后再返回响应。

内容的提问来源于stack exchange，提问作者Prosy A.