django-tables2导出时如何判断请求并调整列表头文本

你的问题根源在于直接修改了列的verbose_name属性，这个属性会被页面渲染和导出功能共同使用，导致导出文件的表头带上HTML代码。下面提供两种可行的解决方案：

方案1：通过请求参数判断导出场景，跳过HTML修改 #

Django表格导出功能（比如django-tables2的导出插件）通常会在请求中携带特定参数，比如format=csv或format=xls。我们可以通过检测这些参数，只在非导出请求时添加表头图标：

class AbstractTable(Table):
    def __init__(self, *args, **kwargs):
        # 从初始化参数中取出request
        self.request = kwargs.pop('request', None)
        super().__init__(*args, **kwargs)

        # 判断是否为导出请求（根据实际导出参数调整）
        is_export = False
        if self.request:
            export_format = self.request.GET.get('format')
            is_export = export_format in ['csv', 'xls', 'xlsx']
        
        # 仅非导出请求时添加默认排序图标
        if not is_export:
            for col in self.columns:
                if is_blank(col.column.verbose_name):
                    my_label = col.name.replace("_", " ").strip()
                else:
                    my_label = col.column.verbose_name.strip()

                arrow = '⇵' if col.orderable else ""
                col.column.verbose_name = mark_safe(f'{my_label} {arrow}')
    
    def before_render(self, request):
        # 同样判断是否为导出请求
        export_format = request.GET.get('format')
        is_export = export_format in ['csv', 'xls', 'xlsx']
        
        if not is_export and "sort" in request.GET:
            which_column = request.GET["sort"]
            reverse_sort = which_column.startswith("-")
            
            if reverse_sort:
                which_column = which_column[1:]
                arrow = '<i class="fa-solid fa-arrow-down-z-a"></i>'
            else:
                arrow = '<i class="fa-solid fa-arrow-down-a-z"></i>'
            
            # 找到目标列（用next避免索引越界）
            target_col = next((col for col in self.columns if col.name == which_column), None)
            if target_col:
                new_name = target_col.verbose_name.replace(' &#x21f5;', '')
                target_col.column.verbose_name = mark_safe(f'{new_name} {arrow}')

使用时需要在创建表格实例时传入request：

table = StudentTable(queryset, request=request)

方案2：自定义表头渲染，不修改原始verbose_name（推荐） #

这种方法解耦了页面渲染和原始数据，保留列的原始verbose_name用于导出，仅在页面渲染表头时动态添加图标：

第一步：创建自定义列类 #

from django_tables2 import Column
from django.utils.safestring import mark_safe

class OrderableColumn(Column):
    def render_header(self, bound_column):
        # 获取原始表头文本
        if is_blank(bound_column.column.verbose_name):
            label = bound_column.name.replace("_", " ").strip()
        else:
            label = bound_column.column.verbose_name.strip()
        
        # 仅页面渲染时处理排序图标
        if bound_column.orderable:
            request = bound_column.table.request
            sort_param = request.GET.get('sort', '')
            current_sort_col = sort_param.lstrip('-')
            
            # 根据当前排序状态显示对应图标
            if current_sort_col == bound_column.name:
                arrow = '<i class="fa-solid fa-arrow-down-z-a"></i>' if sort_param.startswith("-") else '<i class="fa-solid fa-arrow-down-a-z"></i>'
            else:
                arrow = '&#x21f5;'
            
            return mark_safe(f'{label} {arrow}')
        return label

第二步：修改AbstractTable使用自定义列 #

class AbstractTable(Table):
    class Meta:
        default_column_class = OrderableColumn
    
    def __init__(self, *args, **kwargs):
        self.request = kwargs.pop('request', None)
        super().__init__(*args, **kwargs)

这种方案下，导出功能会直接使用列的原始verbose_name，不会带上任何HTML代码，同时页面渲染的表头图标逻辑完全独立，代码更易维护。

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