在 SeaORM 中修改部分字段核心在于利用 ActiveModel 的 ActiveValue 状态系统。你只需将需要修改的字段设置为 Set其他字段保持为 Unchanged 或 NotSet生成的 SQL 就只会包含你设置的那些列。### 方法一通过 ActiveModel 更新单条记录这是最常用的方式适用于已知主键、需要更新特定字段的场景。**步骤**1. 根据主键查询记录获得 Model。2. 将 Model 转换为 ActiveModel此时所有字段状态为 Unchanged。3. 将需要修改的字段设置为 Set(新值)。4. 调用 update(db) 方法。**示例** 更新水果的名称为 Sweet pear其他字段不变。rustuse sea_orm::{entity::*, query::*, DbConn};use sea_orm::ActiveValue::Set;// 1. 查询记录let pear: Optionfruit::Model Fruit::find_by_id(28).one(db).await?;let pear pear.unwrap();// 2. 转换为 ActiveModel (所有字段变为 Unchanged)let mut pear: fruit::ActiveModel pear.into();// 3. 只修改 name 字段pear.name Set(Sweet pear.to_owned());// 4. 执行更新// 生成的 SQL: UPDATE fruit SET name Sweet pear WHERE id 28let pear: fruit::Model pear.update(db).await?;关键点update 方法会根据主键自动生成 WHERE 条件并且只更新状态为 Set 的字段。### 方法二使用 update_many 进行批量条件更新如果你需要根据条件更新多条记录且不想逐条查询可以使用 Entity::update_many() 构建器。**方式 A使用 col_expr 直接设置列值**rustuse sea_orm::{entity::*, query::*, DbConn};// 将所有名称包含 Apple 的记录cake_id 设为 1// SQL: UPDATE fruit SET cake_id 1 WHERE fruit.name LIKE %Apple%Fruit::update_many().col_expr(fruit::Column::CakeId, Expr::value(1)).filter(fruit::Column::Name.contains(Apple)).exec(db).await?;这种方式直接指定列和值适合简单的字段赋值。**方式 B使用 set 方法传入 ActiveModel**你也可以构建一个只设置了部分字段的 ActiveModel然后通过 .set() 传给 update_many。rustuse sea_orm::ActiveValue::Set;let partial_update fruit::ActiveModel {name: Set(Updated Apple.to_owned()),..Default::default() // 其他字段为 NotSet不会被更新};Fruit::update_many().set(partial_update).filter(fruit::Column::Id.eq(1)).exec(db).await?;使用 ..Default::default() 可以确保未指定的字段状态为 NotSet从而不会被包含在 SET 子句中。### 方法三使用 DerivePartialModelSeaORM 2.0SeaORM 2.0 引入了 DerivePartialModel它允许你定义只包含部分字段的结构体并可以将其转换为 ActiveModel 用于更新。对于只关心少数几个字段的场景这能显著简化代码。rustuse sea_orm::DerivePartialModel;#[derive(DerivePartialModel)]#[sea_orm(entity fruit::Entity, into_active_model)]struct FruitNameUpdate {id: i32,name: String,}let partial FruitNameUpdate {id: 28,name: Lemon Drizzle.to_owned(),};let active_model: fruit::ActiveModel partial.into_active_model();// 此时只有 id 和 name 是 Set 状态其他字段为 NotSet之后你可以用这个 ActiveModel 去执行更新。未包含在 PartialModel 中的属性会自动填充为 NotSet这在构建部分更新时非常有用。### 补充强制更新未修改的字段有时你需要强制更新某个字段即使它的值没有变化。可以使用 reset 或 reset_all 方法rustlet mut pear: fruit::ActiveModel pear.into();pear.name Set(Sweet pear.to_owned());// 强制更新 cake_id 字段pear.reset(fruit::Column::CakeId);// 或者强制更新所有字段// pear.reset_all();// SQL: UPDATE fruit SET name Sweet pear, cake_id 10 WHERE id 28pear.update(db).await?;reset 会将指定列的 Unchanged 状态转为 Set使其被包含在 UPDATE 语句中。### 总结| 场景 | 推荐方法 | 关键操作 || :--- | :--- | :--- || **更新单条记录的部分字段** | ActiveModel update | 将 Model 转为 ActiveModel修改字段为 Set || **根据条件批量更新** | update_many col_expr | 直接指定列和值配合 filter || **批量更新且只设置部分列** | update_many set(ActiveModel) | 构建部分设置的 ActiveModel用 ..Default::default() || **SeaORM 2.0 简化部分更新** | DerivePartialModel | 定义部分结构体into_active_model 后更新 || **强制更新未修改字段** | reset 或 reset_all | 将 Unchanged 状态转为 Set |核心原则是**只有状态为 Set 的字段才会出现在 UPDATE 的 SET 子句中**利用好 ActiveValue 的状态机制就能精准控制部分更新。