对Django中@admin.display()装饰器语法的困惑与疑问

你遇到的@admin.display(...)是带参数的装饰器工厂函数，和你学的基础装饰器本质逻辑一致，只是它的定义位置在类（或模块）的命名空间下，通过.访问调用而已，完全合法。

核心逻辑拆解 #

装饰器语法@xxx(...)的本质是两步走：

1. 先调用xxx(...)并传入你指定的参数（比如boolean=True），这个调用会返回一个真正的装饰器函数；
2. 再用这个返回的装饰器去修饰下方的目标函数/方法。

不管xxx是全局函数，还是某个类里的方法，只要它能接收参数并返回装饰器，就可以用这种语法。

模拟类内装饰器工厂的示例 #

自己写个简单例子，就能直观理解这种写法的可行性：

class Admin:
    @staticmethod
    def display(boolean=False, ordering=None, description=""):
        # 这是装饰器工厂，接收参数后返回真正的装饰器
        def decorator(func):
            # 给被装饰的函数附加元数据，模拟Django的逻辑
            func._display_boolean = boolean
            func._display_ordering = ordering
            func._display_description = description
            return func
        return decorator

# 使用类内的装饰器工厂装饰方法
class Article:
    @Admin.display(boolean=True, ordering='pub_date', description='Published recently?')
    def is_recent(self):
        return self.pub_date >= some_date_threshold

这个例子里，Admin.display是类中的静态方法，作为装饰器工厂，调用后返回装饰器，完全支持@Admin.display(...)的语法。

回到Django的场景 #

Django里的admin.display是django.contrib.admin模块下的装饰器工厂函数，它的作用是给Admin后台的自定义字段配置显示规则——你传入的参数会告诉Django：这个字段是否以布尔样式展示、按哪个字段排序、显示的描述文本是什么，本质就是通过装饰器给被修饰的方法附加元数据，供Django Admin框架读取使用。

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