如何将使用Linq to SQL的.NET Framework项目迁移至Entity Framework Core？

云原生阿岚

2026-8-14

将Linq-to-SQL迁移至Entity Framework Core（.NET Core 6）的实操指南

核心结论：无需转换为EDMX文件

EDMX是Entity Framework 6的建模格式，EF Core并不推荐这种设计器驱动的方式，且对EDMX的支持非常有限，直接跳过这一步，迁移到EF Core的代码优先或数据库优先模式即可。

先备份.dbml文件和自动生成的设计器代码文件（如YourDb.designer.cs），避免误操作丢失内容。
从项目中移除.dbml文件及关联设计器文件。
清理自动生成的实体类：
- 删除Linq-to-SQL特有的属性，保留的[Table]属性需替换为EF Core命名空间下的对应特性（来自Microsoft.EntityFrameworkCore）。
- 用[Key]特性（来自System.ComponentModel.DataAnnotations）标记实体的主键属性。
- 移除OnCreated()等Linq-to-SQL生命周期方法，将类改为纯POCO（Plain Old CLR Object）。
创建EF Core的DbContext类，定义对应实体的DbSet<Entity>属性，并重写OnConfiguring方法配置数据库连接字符串。

这是高效且不易出错的方式，直接从数据库结构生成符合EF Core规范的实体和DbContext：

在项目中安装必要NuGet包：
- Microsoft.EntityFrameworkCore
- Microsoft.EntityFrameworkCore.Tools
- 对应数据库类型的Provider包（如SQL Server用Microsoft.EntityFrameworkCore.SqlServer）
打开Visual Studio包管理器控制台，执行反向工程命令：
```
Scaffold-DbContext "Server=你的服务器名;Database=你的数据库名;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Data -Context YourDbContext
```
参数说明：
- -OutputDir：指定实体类生成目录
- -ContextDir：指定DbContext类生成目录
- -Context：指定DbContext的名称
对比生成代码与原Linq-to-SQL实体，调整命名或字段映射，替换原项目中Linq-to-SQL的使用代码，改为新的DbContext和实体。

除了控制台命令，也可通过GUI操作：

右键项目 → 添加 → 新建项 → 搜索“EF Core DbContext” → 选择“EF Core DbContext from Database”，按向导选择数据库连接、要生成的表，即可自动生成实体和DbContext。

既然你希望彻底脱离Linq-to-SQL依赖，不建议使用该库。它只是Linq-to-SQL在.NET Core上的兼容层，无法获得EF Core的全部特性（如迁移、性能优化、跨数据库支持等），长远来看迁移到EF Core是更可靠的选择。

从小处着手：先挑选一个简单业务模块，替换其中的Linq-to-SQL查询为EF Core实现，验证功能正常后再逐步推广。
熟悉EF Core基础：重点掌握DbContext、DbSet、LINQ查询基本用法，以及跟踪/无跟踪查询的区别（AsNoTracking()）。
处理查询差异：Linq-to-SQL和EF Core的LINQ语法大部分兼容，但少数方法或函数有差异（如Linq-to-SQL的DataLoadOptions对应EF Core的Include/ThenInclude实现关联查询加载），遇报错可对照EF Core文档调整。
利用迁移工具：后续修改数据库结构时，使用EF Core迁移命令（Add-Migration、Update-Database）管理版本，避免手动修改数据库。

内容的提问来源于stack exchange，提问作者0xSingularity