Django ModelAdmin中list_display字段需显式声明且必须真实存在：模型字段、外键展开（如author__username）、或ModelAdmin内定义的带short_description的方法；action须手动加入actions列表并规范参数顺序；search_fields仅前缀匹配，外键需用__语法；get_queryset务必调用super()以保权限逻辑。
ModelAdmin里改list_display不显示字段？
Django默认只显示<strong>str</strong>返回值，加字段必须显式声明。常见错误是写了字段名但模型里没定义，或者用了外键字段却没加_name后缀（比如author会报错，得写author__name）。
- 确保字段真实存在于模型中，或为ModelAdmin内定义的可调用方法（带
short_description属性） - 外键字段要展开：用
user__email而非user - 方法字段需在ModelAdmin类里定义，不能只在Model里有
- 字段名含下划线不影响，但别拼错——
pub_date写成pub_datee就静默失效
class ArticleAdmin(admin.ModelAdmin):
list_display = ['title', 'status', 'author__username', 'formatted_created']
<pre class='brush:python;toolbar:false;'>def formatted_created(self, obj):
return obj.created_at.strftime('%Y-%m-%d')
formatted_created.short_description = '创建日期'想批量操作但action不出现？
Django不会自动注册自定义action，必须手动加到actions列表，且函数要有short_description。
- 函数第一个参数是ModelAdmin实例，第二个是request，第三个是QuerySet——顺序错会导致
TypeError: my_action() missing 1 required positional argument - action函数必须返回
None或HttpResponse，返回字符串会触发“未处理的返回值”警告 - 如果只对部分对象生效，记得在函数开头加
if not queryset:保护
def make_published(modeladmin, request, queryset):
queryset.update(status='published')
make_published.short_description = "标记为已发布"
<p>class ArticleAdmin(admin.ModelAdmin):
actions = [make_published] # 必须显式加入</p>search_fields模糊搜索没效果？
Django的search_fields默认走LIKE查询，但只支持字段前缀匹配（如title查"django"能命中"django教程"，但查"教程"就不行），且对JSONField、ForeignKey本身不直接支持。
- 外键字段要写
author__name，不能写author - 想支持全文搜索得换
SearchVector+ PostgreSQL，或集成Haystack/Whoosh - 字符串字段建议加数据库索引：
db_index=True，否则大数据量时卡顿明显 - 多字段联合搜索是OR逻辑，不是AND——搜"张 三"会分别匹配
first_name含"张"或last_name含"三"
覆盖get_queryset()后列表页403或数据为空？
重写get_queryset()是最容易出权限问题的地方。Django Admin默认会过滤掉被删除对象（is_active=False），但你一覆盖就可能绕过这个逻辑，导致用户看到空列表，或更糟——看到不该看的数据。
立即学习“Python免费学习笔记（深入）”；
- 一定要调用
super().get_queryset(request)再链式过滤，而不是从Model.objects.all()重头来 -
request.user在这里可用，但别假设它一定有profile等扩展属性，先hasattr判断 - 如果做了
select_related或prefetch_related，注意别和list_display里的外键展开重复，引发N+1
def get_queryset(self, request):
qs = super().get_queryset(request)
if request.user.is_superuser:
return qs
return qs.filter(author=request.user) # 普通用户只能看自己的
ModelAdmin看着只是配几个列表字段，但每个钩子背后都连着QuerySet生命周期、权限校验和模板渲染链。改get_form()或save_model()之前，先确认你真需要绕过Django默认的save逻辑——多数时候字段级限制用formfield_overrides或ModelForm更稳。
