如何修改Django Admin中模型字段list_display的显示标签？

当模型字段的verbose_name适合编辑页面但在列表页过长时，你可以通过以下几种方式单独设置列表页的字段标签：

方法一：自定义显示方法并设置short_description #

在Admin类中定义一个对应字段的显示方法，然后给该方法添加short_description属性，以此指定列表页的短标签：

示例代码 #

模型定义：

from django.db import models

class MyModel(models.Model):
    # 编辑页使用长verbose_name
    extended_detail = models.CharField(max_length=200, verbose_name="用户详细信息（包含注册来源与偏好设置）")

Admin配置：

from django.contrib import admin
from .models import MyModel

class MyModelAdmin(admin.ModelAdmin):
    # 将自定义方法加入list_display
    list_display = ('short_detail_label',)

    def short_detail_label(self, obj):
        # 返回原字段的值
        return obj.extended_detail
    
    # 设置列表页的短标签
    short_detail_label.short_description = "用户信息"
    # 可选：允许按原字段排序
    short_detail_label.admin_order_field = 'extended_detail'

admin.site.register(MyModel, MyModelAdmin)

方法二：使用@admin.display装饰器（Django 3.2+） #

Django 3.2及以上版本提供了更简洁的@admin.display装饰器，直接在自定义方法上指定描述和排序字段：

示例代码 #

from django.contrib import admin
from .models import MyModel

class MyModelAdmin(admin.ModelAdmin):
    list_display = ('short_detail_label',)

    @admin.display(description="用户信息", ordering='extended_detail')
    def short_detail_label(self, obj):
        return obj.extended_detail

admin.site.register(MyModel, MyModelAdmin)

关键说明 #

• 模型字段的verbose_name是全局属性，会同时作用于编辑页和列表页，无法直接拆分设置；
• 通过自定义列表列的方式，既能保留原字段在编辑页的长标签，又能在列表页显示更简洁的名称；
• 如果需要让自定义列支持排序，必须指定admin_order_field或在装饰器中设置ordering参数，关联到对应的模型字段。

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