Django中admin.register与admin.site.register的差异及使用选择

首先得明确你之前遇到问题的根源：你误用了admin.register的用法。虽然它是admin.site.register的别名，但两者的调用逻辑完全不同：

• admin.register是装饰器，只能用来装饰你的ModelAdmin子类，正确用法是：

  from django.contrib import admin
  from .models import ApiRequestLog
  
  @admin.register(ApiRequestLog)
  class ApiRequestLogAdmin(admin.ModelAdmin):
      # 这里写Admin类的配置，比如list_display、search_fields等
      list_display = ('user', 'request_time', 'endpoint')
  

  你之前直接调用admin.register(ApiRequestLog, ApiRequestLogAdmin)，这不是装饰器的正确使用方式，相当于没有完成有效的注册，自然不会生成Admin对应的URL，反向解析也会失败。

• admin.site.register是普通函数，需要传入模型类和对应的ModelAdmin类（如果自定义了的话），你的第二种写法是完全正确的：

  from django.contrib import admin
  from .models import ApiRequestLog
  from .admin import ApiRequestLogAdmin
  
  admin.site.register(ApiRequestLog, ApiRequestLogAdmin)
  

该选哪种写法？ #

1. 优先用装饰器写法@admin.register(Model)：

   • 代码更简洁，逻辑连贯：定义Admin类的同时完成注册，不用额外写单独的注册代码。
   • 这是Django官方文档推荐的写法，符合社区最佳实践。

2. 在特定场景用admin.site.register：

   • 当你需要动态注册模型（比如根据配置或运行时条件决定是否注册）。
   • 当你使用了自定义Admin站点（不是默认的admin.site），需要指定具体的站点实例。
   • 当你的Admin类和注册代码不在同一个文件里时，显式调用逻辑更清晰。

只要用对了写法，两种方式的功能完全一致。你之前的问题只是因为错误调用了装饰器，不是写法本身的问题。

内容的提问来源于stack exchange，提问作者João Pedro Martins de Paula