在 Django Admin 中添加自定义动作需在 ModelAdmin 类中定义含 modeladmin、request、queryset 三参数的函数，并注册到 actions 列表；操作后须返回 HttpResponse，耗时任务应交由 Celery 处理；批量更新优先用 queryset.update() 避免 save() 副作用；导出 Excel 推荐 openpyxl，注意响应头、中文文件名和 BytesIO；动作未显示常见于未注册、签名错误或函数私有。
怎么在 Django Admin 里加自定义动作按钮
直接在 ModelAdmin 类里定义 actions 列表，再写一个带三个参数（modeladmin, request, queryset）的函数就行。这个函数会被 Django 自动调用，传入用户勾选的记录集合。
- 函数必须定义在
ModelAdmin类内部或同模块下，然后手动加进actions = [my_action] -
queryset是真实数据库查询集，不是列表——所以别对它用list()或循环多次，否则可能重复执行或漏数据 - 操作完成后一定要返回
HttpResponse（比如messages.info+redirect），否则页面会卡在“正在处理”，且无反馈 - 如果动作涉及耗时操作（如发邮件、调外部 API），别直接在 action 里做，得丢进 Celery，不然请求超时或拖垮 admin
批量修改字段值时为什么改不生效
常见错法是遍历 queryset 然后逐个 save()，这既慢又容易触发信号（pre_save/post_save）导致意外副作用。Django 提供了更安全高效的 update() 方法。
- 用
queryset.update(status='done')而不是for obj in queryset: obj.status = 'done'; obj.save() -
update()不会调用模型的save()方法，因此绕过验证、信号和自定义逻辑——这是优点也是坑点，得确认你不需要这些 - 不能用
update()修改外键或关系字段（如user_id可以，user字段不行），否则报FieldError - 如果字段有默认值或依赖当前时间（如
auto_now_add），update()不会自动填充，得显式写进去，比如updated_at=timezone.now()
导出 Excel 时中文乱码或样式崩了怎么办
Django Admin 默认不支持 Excel 导出，得自己集成库。推荐用 openpyxl（支持 .xlsx，中文友好，可设样式），避开 xlsxwriter（不读旧文件）和 xlwt（只支持老式 .xls，已弃用）。
- 响应头必须设成
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，否则浏览器当普通下载或打不开 - 文件名含中文要用
Content-Disposition的filename*=UTF-8''xxx.xlsx格式，否则 IE/Edge 下乱码 - 别用
StringIO，要BytesIO——openpyxl写的是字节流，用错类型会报TypeError: expected bytes, got str - 导出量大时（>5000 行），别一次性 load 全部数据到内存，用
queryset.iterator(chunk_size=200)分批取
自定义动作没出现在下拉菜单里
最常见原因是没注册进 actions，或者函数签名不对。Django 对 action 函数签名非常严格：必须且只能有三个位置参数，且第一个必须是 modeladmin 实例。
立即学习“Python免费学习笔记（深入）”；
- 检查是否漏了
admin.site.register(MyModel, MyModelAdmin)，光写类不注册等于没写 - 函数名不能以下划线开头（如
_export_data），Django 会忽略私有方法 - 如果用了
@admin.action装饰器，注意它要求 Django ≥ 4.1；低版本只能手动加进actions列表 - 动作函数里抛异常（比如
ValidationError）不会被 admin 捕获，页面直接 500，建议包一层try/except并用self.message_user(request, ...)友好提示
真正难的不是写动作，而是判断哪些逻辑该放 action、哪些该抽成管理命令（manage.py）或独立视图。比如导出上万行数据，用 action 就容易超时，这时就得切到异步任务+前端轮询下载链接——但那个就不是 admin 动作的事了。
