update_fields仅更新已加载字段，不绕过验证但跳过未列字段检查；需确保字段存在于实例中，否则报错或静默失败；批量更新应优先用QuerySet.update()而非逐条save；auto_now字段需显式列入update_fields才更新；配合defer/only可减少IO。
update_fields参数只更新指定字段，但必须是模型实例已加载的字段
直接调用 save(update_fields=['field_name']) 不会跳过字段验证或数据库读取，它只影响 INSERT/UPDATE 语句中 SET 子句的内容。前提是该字段已在当前模型实例中存在（比如你从数据库查出来后改了某个值），否则 Django 会报 ValueError: update_fields must be a list or tuple 或静默忽略未载入的字段。
- 如果字段没在实例里（例如用
MyModel.objects.create(name='x')新建后立刻save(update_fields=['updated_at'])），Django 不知道原始值，也无法生成正确 SQL；更糟的是，某些版本会把未载入字段当作 NULL 写入 -
update_fields不绕过clean()或pre_save信号，但跳过其他字段的验证逻辑（如非空检查仅对列出字段生效） - 使用前建议先确认字段是否已加载：打印
obj.__dict__看对应键是否存在，或用obj._state.adding判断是否为新建对象
批量单字段更新别用 save()，改用 QuerySet.update()
对多条记录只改一个字段（比如统一标记 status='processed'），save() + update_fields 是逐行操作，N 条记录触发 N 次查询+信号+事务开销；而 QuerySet.update() 是单条 SQL，不触发模型方法和信号，性能差距可达数量级。
- 正确写法：
MyModel.objects.filter(id__in=[1,2,3]).update(status='done') - 错误写法：循环每个对象
obj.status = 'done'; obj.save(update_fields=['status']) -
QuerySet.update()返回受影响行数（int），不是模型实例，无法链式调用.select_related()等 - 注意：它不调用
save()，所以auto_now、auto_now_add字段不会自动更新，需显式传入，如updated_at=timezone.now()
datetime auto_now 字段更新时 update_fields 容易漏掉 updated_at
很多模型定义了 updated_at = models.DateTimeField(auto_now=True)，但开发者常只写 obj.name = 'new'; obj.save(update_fields=['name'])，结果 updated_at 没变——因为 auto_now 是在 save() 内部靠字段属性拦截实现的，update_fields 会阻止该逻辑执行。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 必须手动加入：
obj.save(update_fields=['name', 'updated_at']) - 或者改用
auto_now_add=False+ 在视图/服务层显式赋值：obj.updated_at = timezone.now()，再用update_fields - Django 4.2+ 支持
auto_now与update_fields共存，但前提是字段名明确列出，否则仍不更新
update_fields 和 select_related / defer 配合才能真正省 IO
update_fields 本身不减少查询次数，它只减少 UPDATE 语句的字段数。真正省 DB IO 的关键是：先用 defer() 或 only() 加载最少必要字段，再修改并保存。
立即学习“Python免费学习笔记（深入）”；
- 例如只更新状态：
obj = MyModel.objects.defer('description', 'content').get(id=1)，此时obj.__dict__里没有被 defer 的字段，save(update_fields=['status'])就不会意外把 NULL 写进大字段 - 反过来，如果用了
select_related()却没在update_fields里排除外键字段，Django 可能因外键缓存状态异常报ValueError: Cannot force an update in save() with no primary key - 调试技巧：开启
LOGGING中的django.db.backends，看生成的 SQL 是否真只含指定字段
update_fields 不是开关一开就快，它依赖你对数据加载路径和字段状态的精确控制；漏掉一个 updated_at 或误 defer 了关键字段，反而导致数据错乱。 
