你知道吗？从 .NET9 开始删除内置的 Swagger 支持 （Swashbuckle）！
💡
原文中文，约12400字，阅读约需30分钟。
📝
内容提要
微软决定在.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以优先于默认设置。
➡️
