node.js自动生成api文档（apidocjs）

1 win+R 输入 cmd 回车 然后进入 nodejs 项目目录

例如 D:\NodeTest\newApp1

2 用npm安装 apidoc

直接输入 npm install apidoc -g按回车

3 打开项目的 package.json文件

加入 "apidoc": { "title": "apiDoc在浏览器中的标题", "url" : "api.github.com/v1" }

4 给接口添加注释

例如

/**
* @api {post} /api/User/register 用户注册
* @apiDescription 用户注册
* @apiName Register
* @apiGroup User
* @apiParam {string} name 用户名
* @apiParam {string} password 密码
* @apiVersion 1.0.0
*/
复制代码

5 生成 apidoc

输入 apidoc -i api/ -o apidoc/

如果 提示error: Can not read: package.json, please check the format (e.g. missing comma).

说明package.json文件格式不正确，或者编码不对，需要改为utf8 无签名 即可

如果提示 info: Done. 说明生成成功，

打开项目文件夹 会发现生成新目录apidoc，双击打开里面的index.html 即可。

官方地址 apidocjs.com/

参考 blog.youkuaiyun.com/soslinken/a…