最近我們團隊一直進行.net core的轉型,web開發(fā)向著前后端分離的技術架構演進,我們后臺主要是采用了asp.net core webapi來進行開發(fā),開始每次調試以及與前端人員的溝通上都存在這效率低下的問題,一次在看微軟asp.net core官方文檔的時候,發(fā)現(xiàn)了swagger這個好東西。然后在實際的項目中引入了該技術。我們開發(fā)人員測試自己寫的api的過程大大得到了簡化,前端人員也可以根據(jù)我們提供的swagger help pages 自己進行一些前端代碼的測試,大大提高了前后端的開發(fā)效率。下面我就拿我自己的真實上線項目來一步一步的講解如何在asp.net core webapi中引入swagger。(也可以參照微軟官方文檔:https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger)
一、引入swagger Nuget包
右鍵點擊wepapi項目的依賴項,點擊管理Nuget程序包,如下圖: