最近我們團(tuán)隊(duì)一直進(jìn)行.net core的轉(zhuǎn)型，web開(kāi)發(fā)向著前后端分離的技術(shù)架構(gòu)演進(jìn)，我們后臺(tái)主要是采用了asp.net core webapi來(lái)進(jìn)行開(kāi)發(fā)，開(kāi)始每次調(diào)試以及與前端人員的溝通上都存在這效率低下的問(wèn)題，一次在看微軟asp.net core官方文檔的時(shí)候，發(fā)現(xiàn)了swagger這個(gè)好東西。然后在實(shí)際的項(xiàng)目中引入了該技術(shù)。我們開(kāi)發(fā)人員測(cè)試自己寫(xiě)的api的過(guò)程大大得到了簡(jiǎn)化，前端人員也可以根據(jù)我們提供的swagger help pages 自己進(jìn)行一些前端代碼的測(cè)試，大大提高了前后端的開(kāi)發(fā)效率。下面我就拿我自己的真實(shí)上線項(xiàng)目來(lái)一步一步的講解如何在asp.net core webapi中引入swagger。(也可以參照微軟官方文檔：https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger)

一、引入swagger Nuget包

右鍵點(diǎn)擊wepapi項(xiàng)目的依賴項(xiàng)，點(diǎn)擊管理Nuget程序包，如下圖：

Asp.net core WebApi 使用Swagger生成幫助頁(yè)實(shí)例