由於專案需要，這幾天一直在研究如何用swagger生成離線文件，網上也有許多如何解決該問題的方案，很多解決方案都只針對某一個類進行生成文件，這個工作量還不如手動去寫文件，直到我看了如下的程式碼....

主要參考如下程式碼：

按照上述程式碼引入相關包後，本地環境仍然會遇到如下問題：

1.啟動test命令後無法生成swagger.json檔案。

2.生成的文件內容不完整。

上述問題1的現象如下：

原因如圖所示，調過了test命令，後來發現在依賴包中用如下的引入：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.19.1</version>
    <configuration>
        <skipTests>true</skipTests>    <!--預設關掉單元測試 -->
    </configuration>
</plugin>

原本只是想改為false就可以了，但是該依賴的引入已經在第三方包中存在，無法進行修改

解決辦法：在目前本地的pom檔案中再加一個同樣的依賴覆蓋父類中的依賴

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.19.1</version>
    <configuration>
        <skipTests>false</skipTests>    <!--開啟單元測試 -->
    </configuration>
</plugin>

問題2 的原因在於，原來下載下來的index.adoc檔案中顯示如下：

中括號換行了，導致最後一個檔案沒有被載入進來，將中括號改回同一行即可“[]”