最近开发时需要用swagger生成文档，经多次测试，形成了一个完整的生成方案，供大家参考。可以在生成的文档中处定义章节。完整调试，保证可用。 工程后，操作步聚如下： 1、修改生成最终文档的索引文件index.adoc，在src/docs/asciidoc目录中，根据自己需要添加章节 2、修改pom.xml的30行地址，改为需要生成文档的系统地址 3、使用命令：mvncleantest生成接口手册文档 4、生成的的文档路径如下： target\asciidoc\html target\asciidoc\pdf