可能的原因及对应解决方法 #

1. NuGet包版本不兼容或安装异常 #

• 确认已安装正确的依赖包：必须安装Swashbuckle.AspNetCore（它会自动引入兼容的Microsoft.OpenApi包），避免单独安装Microsoft.OpenApi导致版本不匹配。
• 卸载重装相关包：打开NuGet包管理器，移除所有Swashbuckle和Microsoft.OpenApi相关包，重新安装与你ASP.NET Core版本匹配的Swashbuckle.AspNetCore（比如.NET 6对应6.x版本，.NET 7对应7.x版本）。

2. 项目文件缓存或引用损坏 #

• 删除项目的bin和obj文件夹，清理编译缓存后重新生成项目。
• 检查.csproj文件：打开项目文件，确认存在正确的包引用，示例如下：

  <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
  

  若存在重复、错误的引用，直接删除后重新添加。

3. 命名空间冲突 #

• 排查项目中是否自定义了Microsoft.OpenApi命名空间，若有则会导致系统命名空间被覆盖，需重命名自定义的命名空间。
• 尝试使用完全限定类名：在代码中直接写Microsoft.OpenApi.Models.OpenApiInfo替代依赖using语句，验证是否是命名空间冲突导致的识别问题。

4. SDK版本不匹配 #

• 检查项目目标框架：右键项目→属性→应用程序，确认目标框架（如net6.0）与本地安装的.NET SDK版本一致，避免混用不同版本的SDK。

5. Visual Studio缓存问题 #

• 清理VS缓存：删除%USERPROFILE%\AppData\Local\Microsoft\VisualStudio下的缓存文件夹（操作前可备份），重启Visual Studio后重新打开项目。

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