EF Core AddRange怎么用 EF Core批量插入数据教程

AddRange是EF Core批量添加实体的高效方法，仅标记为Added状态，需调用SaveChanges()才真正执行INSERT；支持IEnumerable等集合，不适用AsNoTracking；主键需按自增或手动指定规则处理；大批量时建议分批提交并可禁用自动检测变化。

EF Core 的 AddRange 是批量添加实体到上下文的高效方式，它比循环调用 Add 更快，也比原生 SQL 或第三方库更简洁。关键点是：它只是“标记为新增”，真正写入数据库仍需调用 SaveChanges()。

基本用法：一次添加多个对象

适用于已创建好实体对象集合的场景，比如从 API、文件或表单中批量获取数据后插入。

• 传入 IEnumerable、List 或数组都行
• 所有对象状态被设为 Added，后续 SaveChanges() 会生成一条或多条 INSERT 语句（取决于数据库提供程序和配置）
• 示例：

var users = new List
{
    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 不复杂但容易忽略细节，用对了能省不少事。