VSCode无法识别已安装NuGet包但项目可正常运行

问题概述 #

通过dotnet add package <PACKAGE_NAME>成功添加包后，VSCode的IntelliSense无法识别包中的类型/命名空间，报出CS0246错误：

The type or namespace name 'EntityFrameworkCore' could not be found (are you missing a using directive or an assembly reference?) (CS0246)

同时C#语言服务器日志显示：

[LanguageServerProjectSystem] Failure while loading c:\Users\phjes\Documents\Chirp\src\Chirp.Infrastructure\Chirp.Infrastructure.csproj: Package Microsoft.EntityFrameworkCore.Analyzers, version 7.0.11 was not found. It might have been deleted since NuGet restore. Otherwise, NuGet restore might have only partially completed, which might have been due to maximum path length restrictions.

但dotnet run和dotnet build可正常执行，已尝试dotnet restore、清理NuGet缓存、重启.NET语言服务器均无效。

可行解决方案 #

1. 检查并修正项目文件的包引用 #

打开报错的Chirp.Infrastructure.csproj文件，确认是否存在Microsoft.EntityFrameworkCore.Analyzers的正确引用。若缺失或版本不符，手动添加：

<PackageReference Include="Microsoft.EntityFrameworkCore.Analyzers" Version="7.0.11" PrivateAssets="all" />

保存文件后执行dotnet restore。

2. 解决路径长度限制问题 #

日志提示可能因路径过长导致NuGet还原不完整，可通过两种方式处理：

• 将项目移动到更短的路径下，比如从c:\Users\phjes\Documents\Chirp\src\Chirp.Infrastructure迁移到c:\Projects\Chirp\src\Chirp.Infrastructure
• 启用Windows长路径支持：以管理员身份打开PowerShell，执行命令：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

重启电脑后重新执行dotnet restore。

3. 重置VSCode C#扩展缓存 #

• 完全关闭VSCode
• 删除以下路径中的缓存文件夹（替换<版本号>为你当前C#扩展的版本）：
  Windows：%USERPROFILE%\.vscode\extensions\ms-dotnettools.csharp-<版本号>\.roslyn
• 重新打开VSCode，等待语言服务器重新加载完成

4. 手动安装指定版本的缺失包 #

直接通过命令行手动将指定版本的包安装到目标项目：

dotnet add Chirp.Infrastructure.csproj package Microsoft.EntityFrameworkCore.Analyzers --version 7.0.11

安装完成后重启VSCode的.NET语言服务器。

5. 检查并修复NuGet源 #

确认你的NuGet源可正常访问目标包：

dotnet nuget list source

若源异常，添加官方NuGet源：

dotnet nuget add source https://api.nuget.org/v3/index.json --name nuget.org

之后重新执行dotnet restore。

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