C# EF Core怎么安装 EF Core安装教程

EF Core需安装核心包、数据库提供程序(如SqlServer)及设计工具(如Tools),要求.NET 5+,不支持.NET Framework;装完需重启VS并验证DbContext能否识别UseSqlServer。

EF Core 是 .NET 平台的轻量级、跨平台 ORM 框架,安装非常简单,核心就是通过 NuGet 添加对应包。下面分步骤说清楚怎么装、装什么、要注意什么。

确认项目类型和 .NET 版本

EF Core 要求项目是 .NET 5 或更高版本(包括 .NET Core 3.1、.NET 6/7/8/9)。如果你用的是传统 .NET Framework(如 4.7.2),只能用 EF 6,不能用 EF Core。

  • 在 Visual Studio 中右键项目 → “属性” → 查看“目标框架”
  • 命令行中运行 dotnet --version 确认 SDK 版本

安装 EF Core 核心包

只装 Microsoft.EntityFrameworkCore 不够,它只是基础库。你必须按数据库选一个“提供程序(Provider)”,比如 SQL Server、SQLite、PostgreSQL 等。

  • SQL Server(最常用):Microsoft.EntityFrameworkCore.SqlServer
  • SQLite(轻量本地开发):Microsoft.EntityFrameworkCore.Sqlite
  • PostgreSQL:Npgsql.EntityFrameworkCore.PostgreSQL
  • MySQL:Pomelo.EntityFrameworkCore.MySql

推荐用 Package Manager Console 安装(VS 内置):

Install-Package Microsoft.EntityFrameworkCore.SqlServer

顺便装上设计时支持(生成迁移必备)

如果你要dotnet ef 命令(比如 dotnet ef migrations add Init),还得装工具包:

  • 全局工具(一次安装,全项目可用):dotnet tool install --global dotnet-ef
  • 或项目级引用(推荐):Microsoft.EntityFrameworkCore.Tools(NuGet 包)

装完后重启 VS 或重新加载项目,才能在“包管理器控制台”里识别 dotnet ef 命令。

验证是否装成功

新建一个 DbContext 类,试试能不能编译:

public class AppDbContext : DbContext
{
    public DbSet Products { get; set; }
    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseSqlServer("Server=.;Database=testdb;Trusted_Connection=true;");
}

如果没报红、能识别 UseSqlServerDbSet,说明安装成功。

基本上就这些。不复杂但容易忽略提供程序和工具包,装错一个就跑不起来。