Docker一键部署R3PLAYX：轻量级音乐服务器搭建教程
2026/8/14 12:40:18
Entity Framework Core (EF Core) 已成为 .NET 开发中数据访问的基石工具，为开发人员提供了强大而多功能的解决方案。随着 .NET 8 和 C# 10 中引入的改进，开发人员现在可以使用更丰富的功能和增强功能，从而进一步增强了 EF Core 的功能。
EF有三种开发模式：CodeFirst、ModelFirst、DbFirst，这三种根据业务需求及个人偏好用的相对比较多的是DbFirst和CodeFirst；现在EF Core推荐使用CodeFirst的方式进行项目开发，当然也可以通过反向工程的方式，以数据库设计为先。
以VS2022 和 .Net8.0 做一个 .netcore webapi为例，EF采用 DbFisrt开发模式
第1步： 使用NuGet包管理器安装以下三个依赖项：
Microsoft.EntityFrameworkCore.Tools
EntityFrameworkCore.sqlserver
Microsoft.EntityFrameworkCore.Design
备注：本项目使用的是VS2022, .Net8.0,所以下载EF Core时选择8.0.0版本
第2步：在 appsettings.json 中加入数据库连接字符串
"ConnectionStrings": { "DBConnection": "Server=192.168.XXX.XXX;Database=XXXXX;User Id=XXX;Password=XXXXXX;TrustServerCertificate=True" }第3步：在 .csproj 项目文件中加入控制全球化的配置
第4步：整理命令语名，为生成实例类作准备
完整命令如下：
Scaffold-DbContext -Connection "Server=192.168.XX.XX;Database=XXX;User Id=XXX;Password=XXXXXX;TrustServerCertificate=True" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DBST -UseDatabaseNames -NoOnConfiguring
参数详解：
| 参数 | 作用 | 补充说明 |
|---|---|---|
| Scaffold-DbContext | EF Core 的反向工程 | 采用DbFirst 模式 |
| -Connection | 数据库连接字符串 | 包含服务器地址、数据库名、登录账号、密码，TrustServerCertificate=True用于跳过 SSL 证书验证（开发环境常用，生产环境需谨慎） |
| -Provider | 指定 EF Core 数据库提供程序 | 这里用Microsoft.EntityFrameworkCore.SqlServer，对应 SQL Server。如果是 MySQL 则用Pomelo.EntityFrameworkCore.MySql等 |
| -OutputDir | 指定生成的实体类文件的输出目录（相对于项目根目录） | 会在项目中创建 / 使用Models文件夹，存放生成的数据库表对应的实体类 |
| -ContextDir | 指定生成的 **DbContext类文件 ** 的输出目录（相对于项目根目录） | 会在项目中创建 / 使用 |
| -Context | 指定生成的DbContext类的名称 | 生成的上下文类名是DBST（替代默认的命名，可根据需要变更） |
| UseDatabaseNames | 强制生成的实体类、属性名称与数据库表、列名完全一致 | 默认 EF Core 会将数据库名（如t_student_info）转成 Pascal 命名（TStudentInfo），加此参数后保持原名（t_student_info对应类名t_student_info） |
| -NoOnConfiguring | 不生成DbContext中的OnConfiguring方法 | 通常我们会通过依赖注入（DI）配置数据库连接，而非硬编码在OnConfiguring，加此参数后，生成的DbContext不会包含自己写死连接字符串的逻辑，更符合 “配置与代码分离” 的最佳实践 |
第5步：执行命令，生成实体类和上下文类
点击 工具 --> NuGet包管理器 --->程序包管理控制台 ，把第4步整理好的命令得到到控制台：
生成成功后，项目的架构中会多出Context 和 Mideks文件夹及相应的类：
需要指出的是，如果再次执行的时候，需要在后面加一个 -Force ， 意思是EF Core 为了避免意外覆盖你的现有文件而默认采取不覆盖的策略，需要添加 -Force 参数来实现强制覆盖。
第6步：在Program.cs文件中，将 DBST 类注册为服务。（使其可通过依赖注入在控制器、服务中使用）
说明：
options.UseSqlServer(...) 作用： 数据库提供商，指定使用 SQL Server 数据库。
若用其他数据库（如 MySQL），需替换为对应方法：
options.UseMySql(...) // MySQL
options.UseNpgsql(...) // PostgreSQL