Entity Framework Core安装失败求助：已尝试多种常规方案无效

开发者阿泽

2026-5-22

针对Entity Framework NuGet包无法安装的排查方案

嘿，我之前碰到过几乎一模一样的糟心事，查了一堆资料才搞定，给你几个亲测有效的步骤：

先清理本地NuGet缓存：缓存损坏是最常见的坑，打开命令行到项目目录，运行：
```
dotnet nuget locals all --clear
```
清理完再尝试重新安装EF包，命令用：
```
dotnet add package Microsoft.EntityFrameworkCore
```
（如果是用老版本Entity Framework 6，就换成dotnet add package EntityFramework）
检查NuGet源配置：有时候默认源可能出问题或者被限制了，先查看当前源：
```
dotnet nuget list source
```
如果看不到nuget.org的官方源，就添加一个：
```
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org
```
要是有其他可疑的源，也可以暂时移除试试。
确认项目目标框架与EF版本兼容：不同版本的EF对项目框架要求不一样，比如：
- .NET Framework 4.6.1及以下只能用EF Core 2.x版本
- .NET 5+可以用EF Core 5.x及以上稳定版
  打开你的.csproj文件，查看<TargetFramework>节点，然后选择对应版本的EF包安装，比如针对.NET Framework 4.6.1，安装命令改成：
```
dotnet add package Microsoft.EntityFrameworkCore --version 2.2.6
```
调整工具引用版本：你添加的Microsoft.EntityFrameworkCore.Tools.DotNet版本要和EF包版本匹配，不能差太多。比如你装EF Core 6.x的话，工具引用也要改成6.x的稳定版：
```
<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="6.0.25" />
```
修改完保存.csproj，再运行dotnet restore试试。
手动添加包引用：如果CLI命令一直失败，直接在.csproj里手动添加包节点，比如：
```
<ItemGroup>
  <PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.25" />
</ItemGroup>
```
然后在项目目录运行dotnet restore，一般都能搞定。