node.js自动生成接口文档

Node.js 自动生成接口文档通常通过第三方工具完成，其中最流行的是`Swagger`（现在更推荐使用`openapi-generator`）和`ApiDoc`。例如：

1. **Swagger** (尤雨溪团队维护的Swagger UI for Node.js)：它是一个基于RESTful API的设计规范，提供了用于创建、描述、操作和文档化RESTful Web服务的工具。你可以编写YAML或JSON文件描述API，然后使用`swagger-jsdoc`库解析它们，并使用`swagger-ui-express`展示生成的文档。

npm install swagger-jsdoc express/swagger-ui-express --save

然后，配置一个`swagger.json`文件并运行`swagger-jsdoc`生成文档。

2. **apidoc**：这是一个简洁易用的文档生成器，支持多种模板风格，包括markdown、HTML等。安装完成后，只需提供相关的注解到源码中，然后运行`apidoc`命令即可生成文档。

npm install apidoc -g
apidoc -i src -o docs

在生成的文档中，开发者可以方便地查看API的各种信息，如请求方法、URL、参数、返回值等。