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