DEV Community
·
在.NET 9中没有Swagger？你需要知道的事项！
内容提要
.NET 9引入内置OpenAPI支持和新的API查看器Scalar，取代默认的Swagger Gen。用户可通过Nuget包管理器轻松添加Scalar或Swagger，配置后即可查看API。Scalar提供可定制主题，提升开发体验。
关键要点
-
.NET 9引入内置OpenAPI支持，取代默认的Swagger Gen。
-
新推出的API查看器Scalar更现代化，用户友好。
-
用户需升级Visual Studio以支持.NET 9。
-
通过Nuget包管理器轻松添加Scalar或Swagger。
-
创建新项目时选择.NET 9作为目标框架，并配置HTTPS和控制器。
-
安装Scalar.AspNetCore包以添加Scalar，或安装Swashbuckle.AspNetCore包以使用Swagger。
-
在开发环境中配置API映射以查看API接口。
-
Scalar提供可定制主题，提升开发体验。
延伸解读
OpenAPI支持的优势
在.NET 9中，内置的OpenAPI支持为开发者提供了更灵活的API文档和探索方式。与传统的Swagger Gen相比，OpenAPI能够更好地满足现代开发需求，提升API的可用性和可维护性。
Scalar的用户体验
Scalar作为新的API查看器，提供了更直观的用户界面和可定制主题，旨在提升开发者的使用体验。开发者可以根据项目需求选择合适的主题，增强视觉效果和操作便捷性。
升级与配置注意事项
使用.NET 9前，确保将Visual Studio升级到最新版本，以支持新功能。此外，在创建新项目时，务必选择.NET 9作为目标框架，并正确配置HTTPS和控制器，以确保项目顺利运行。
延伸问答
.NET 9中Swagger被替代的是什么？
Swagger被内置的OpenAPI支持和新的API查看器Scalar所替代。
如何在.NET 9项目中添加Scalar或Swagger？
可以通过Nuget包管理器安装Scalar.AspNetCore或Swashbuckle.AspNetCore包来添加Scalar或Swagger。
使用Scalar的好处是什么？
Scalar提供了更现代化和用户友好的界面，并且支持可定制主题，提升开发体验。
在创建新项目时需要选择什么框架？
在创建新项目时，需要选择.NET 9作为目标框架，并配置HTTPS和控制器。
使用Scalar时如何配置API映射？
在开发环境中，可以通过调用app.MapOpenApi()和app.MapScalarApiReference()来配置API映射。
升级Visual Studio的原因是什么？
需要升级Visual Studio以支持.NET 9的功能和特性。
