珊妹子刚入职新公司就接触到apidoc这个生成接口文档的技术，刚刚学习的时候，它本身是有手册的，但是也是就介绍安装和语法，实际遇到的问题，还得自己来抠，这个apidoc是通过后台写接口的注释来达到自动生成接口文档的作用。
apidoc是基于node使用的，所以具体安装方法请参考：https://www.cnblogs.com/minsons/articles/7154090.html
安装和使用这里我就不做过多介绍了，网上一搜一大堆，我这里主要说一下遇到的问题吧：
1.当我们想把多个文件生成一个文档的时候，这时要注意分组了，如果你想要所有接口写在一个分组下，可以这样写：
/**
* @apiDefine GroupName 小程序-仓库管理
*/
/**
* @api {post} /WareHouses/index 获取仓库数据
* @apiName 仓库数据
* @apiGroup GroupName
* @apiVersion 1.0.0在上面定义一个分组名，然后下面每个接口都引用这个分组名，就会得到这样的目录结构：
但是，在多个文件同时生成一个文档时，不同文件是不同的模块，需要在不同的分组里，这样的操作，生成文档会有遗漏的接口没有生成文档，就像这样客户的接口跑到了仓库的分组里，因为不同文件里可能会存在相同的方法名，这样生成的文档会乱，怎样解决这个问题呢？请往下看：
首先找到api_group.js，一般是在C:\Users\Administrator\AppData\Roaming\npm\node_modules\apidoc\node_modules\apidoc-core\lib\workers\api_group.js 然后把//group = group.replace(/[^\w]/g, '_');这行代码注释掉，这行代码的意思是分组名可以用中文显示，回到接口文件去掉统一定义的：
/**
* @apiDefine GroupName 小程序-仓库管理
*/把每个接口的apidoc注释中的：
* @apiGroup 小程序-仓库管理都改成当前接口的分组名，这样多个文件同时生成一个接口文档就可以了，以下是成功的示例：
扫描二维码关注公众号，回复：
6127236 查看本文章
完美~