缩略图生成必须在模型save()方法中完成，确保原始图写入磁盘后立即用pillow处理并保存至storage，避免竞态和404；需判断图片是否变更、处理rgba转rgb、指定format与quality、使用thumbnail()和resampling.lanczos，并保证路径经default_storage处理。
缩略图生成必须在模型保存时触发，不能靠视图或表单临时处理
因为缩略图是原始图片的衍生资产，一旦原始文件写入磁盘后被其他进程读取（比如 Nginx 直接服务静态资源），再补生成就容易出现竞态或 404。所以最稳妥的方式是在 save() 方法里完成：原始图存好 → 立即用 Pillow 读取 → 生成缩略图 → 写入新路径 → 保存字段值。
常见错误是把缩略图逻辑放在表单 clean() 或视图 post() 中——这时文件还没落盘，self.image.path 可能为空或指向临时位置，Pillow 打不开。
- 确保模型字段是
ImageField，且upload_to已设置（否则.path不可靠） - 重写
save()前先调用super().save(*args, **kwargs)，保证原始图已写入文件系统 - 缩略图路径建议与原图同目录、前缀或后缀区分，例如
original.jpg→original_thumb.jpg
重写 save() 时要避开“递归保存”和“字段未变更却反复生成”
直接在 save() 里修改模型字段（如 self.thumbnail = new_path）后再调用 super().save()，会导致无限递归——因为再次 save 又会进这个方法。正确做法是用 force_insert 和 force_update 控制，或改用 update_fields。
另一个坑是每次 save 都无条件生成缩略图，哪怕只是改了标题字段。应该只在图片实际变更时才处理：
- 用
self.pk is not None判断是否为更新操作 - 通过
hasattr(self, '_state') and self._state.adding区分新建 vs 更新（更准确） - 对比
self.image.name和数据库旧值（需先get()原始对象）——但注意避免 N+1 查询 - 更轻量的做法：检查
self.image.file.size > 0且not self.thumbnail，适合首次上传场景
Pillow 处理需指定 format 和 quality，否则 WebP 图片可能变 PNG 或体积失控
Image.save() 默认按文件扩展名推断格式，但有时原始图是 .webp 而缩略图想统一输出为 .jpg（兼容性更好），就必须显式传 format='JPEG'。不指定 quality 参数时，PIL 默认用 75，但对小缩略图来说 60–70 更合适，体积能减 30% 以上且肉眼难辨。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
还要注意：thumbnail() 是原地缩放（保持宽高比，不拉伸），resize() 是强制尺寸（会变形）。多数缩略图需求应优先用 thumbnail()：
img.thumbnail((300, 300), Image.Resampling.LANCZOS)
- 务必用
Image.Resampling.LANCZOS（Pillow 10+），旧版的ANTIALIAS已弃用 - 如果原始图是 RGBA 模式（带透明通道）而目标格式是 JPEG，需先转为 RGB：
img = img.convert('RGB') - 写入文件前，用
default_storage.save(thumb_path, ContentFile(buffer.getvalue()))，别直接写磁盘路径（兼容 S3 等后端）
部署到生产环境时，缩略图路径别硬编码，要走 Django 的 storage 机制
本地开发用 FileSystemStorage，线上可能切到 S3Boto3Storage。如果在 save() 里手动拼接 /var/www/media/...，上线就挂。所有路径操作必须经由 default_storage：
- 获取原始图：
default_storage.open(self.image.name) - 写入缩略图：
default_storage.save(thumb_name, ContentFile(...)) - 生成可访问 URL：
default_storage.url(thumb_name)（不是settings.MEDIA_URL + thumb_name）
另外，Django 4.2+ 的 ImageField 支持 width_field/height_field 自动记录尺寸，但缩略图尺寸得自己算、自己存字段，别指望它自动同步。
最易被忽略的是：生成缩略图的代码必须能处理并发上传——Pillow 是线程安全的，但多个请求同时写同一个缩略图路径会冲突。要么加文件锁（复杂），要么确保缩略图路径含唯一标识（如哈希值或时间戳），或者依赖 storage 后端的原子写入能力。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
