EF Core 的
AddRange是批量添加实体到上下文的高效方式,它比循环调用
Add更快,也比原生 SQL 或第三方库更简洁。关键点是:它只是“标记为新增”,真正写入数据库仍需调用
SaveChanges()。
基本用法:一次添加多个对象
适用于已创建好实体对象集合的场景,比如从 API、文件或表单中批量获取数据后插入。
传入IEnumerable<t></t>、
List<t></t>或数组都行 所有对象状态被设为
Added,后续
SaveChanges()会生成一条或多条
INSERT语句(取决于数据库提供程序和配置) 示例:
var users = new List<User>
{
new User { Name = "张三", Email = "zhang@example.com" },
new User { Name = "李四", Email = "li@example.com" },
new User { Name = "王五", Email = "wang@example.com" }
};
context.Users.AddRange(users); // 仅跟踪,不提交
context.SaveChanges(); // 此时才真正执行 INSERT
配合 AsNoTracking 提升性能?别搞混了
AddRange本身不需要、也不建议先用
AsNoTracking—— 因为
AsNoTracking是查询方法,对新增无意义。误用会导致编译错误或逻辑混乱。 ✅ 正确:直接 new 对象 →
AddRange→
SaveChanges❌ 错误:
context.Users.AsNoTracking().AddRange(...)(语法不合法) ⚠️ 注意:如果实体来自查询结果且你打算修改后插入(少见),需先
Detach或
Clone,避免状态冲突
处理主键:自增 vs 手动指定
EF Core 默认按模型配置决定主键行为。批量插入时要注意:
主键是数据库自增(如 SQL Server 的IDENTITY):实体中主键值可为 0 或
default,EF Core 会忽略它,由数据库生成 主键需手动指定(如 GUID、业务编码):确保每个对象的主键值唯一且非空,否则可能抛出异常或覆盖数据 若想让 EF Core 在
SaveChanges后自动获取数据库生成的 ID(如自增主键),确保属性标记了
[DatabaseGenerated(DatabaseGeneratedOption.Identity)],并启用
context.Entry(entity).Property(e => e.Id).IsModified = false;(通常默认即可)
性能优化小技巧
大批量插入(如上万条)时,
AddRange + SaveChanges可能变慢,因为 EF Core 默认每条 INSERT 都走完整变更追踪流程。 分批提交:每 100–1000 条调用一次
SaveChanges(),减少内存压力和事务日志体积 禁用自动检测变化(可选):
context.ChangeTracker.AutoDetectChangesEnabled = false;,插入完再设回
true考虑替代方案:超大数据量(>5 万)推荐用
SqlBulkCopy(SQL Server)或第三方库如
EFCore.BulkExtensions
基本上就这些。AddRange 不复杂但容易忽略细节,用对了能省不少事。
