你知道吗？从 .NET9 开始删除内置的 Swagger 支持 （Swashbuckle）！
内容提要
微软决定在.NET 9中移除内置的Swagger支持（Swashbuckle），原因是维护问题和ASP.NET Core的演变。取而代之的是Scalar.AspNetCore，提供基于OpenAPI的API文档生成，开发者可通过安装相关NuGet包并配置应用程序来使用。
关键要点
-
微软决定在.NET 9中移除内置的Swagger支持（Swashbuckle）。
-
移除的原因包括维护问题和ASP.NET Core的演变。
-
ASP.NET Core现在内置了对Web API元数据的支持，减少了对外部工具的需求。
-
团队希望将OpenAPI作为ASP.NET Core的一等公民，并扩展其文档生成功能。
-
Visual Studio提供了对.http文件的内置支持和新的Endpoints Explorer作为替代工具。
-
Scalar.AspNetCore是新的替代方案，提供基于OpenAPI的API文档生成。
-
开发者可以通过安装NuGet包Scalar.AspNetCore并配置应用程序来使用它。
-
示例代码展示了如何在.NET 9中使用Scalar.AspNetCore。
-
提供了如何添加Bearer身份验证方案的示例代码。
-
创建ASP.NET Core Web API项目的步骤被详细列出，包括安装必要的NuGet包。
-
Scalar的配置扩展允许自定义Scalar UI的行为。
-
可以通过依赖注入配置ScalarOptions以优先于默认设置。
延伸问答
为什么微软决定在.NET 9中移除Swagger支持？
微软移除Swagger支持是因为维护问题和ASP.NET Core的演变，减少了对外部工具的需求。
Scalar.AspNetCore是什么？
Scalar.AspNetCore是一个新的.NET包，提供基于OpenAPI的API文档生成，替代了内置的Swagger支持。
如何在.NET 9中使用Scalar.AspNetCore？
可以通过安装NuGet包Scalar.AspNetCore并在应用程序中进行配置来使用它。
如何在Scalar中添加Bearer身份验证方案？
可以通过实现IOpenApiDocumentTransformer接口并在文档中添加安全方案来实现Bearer身份验证。
Visual Studio在.NET 9中提供了哪些替代Swagger的工具？
Visual Studio提供了对.http文件的内置支持和新的Endpoints Explorer作为替代工具。
如何创建ASP.NET Core Web API项目？
可以通过命令行创建项目，安装必要的NuGet包，并运行项目来创建ASP.NET Core Web API。
