Swagger jsdoc 不会即时更新 api 文档的更改？答案

【问题标题】：Swageer js doc does not instant update api docs on changes?Swagger jsdoc 不会即时更新 api 文档的更改？
【发布时间】：2019-09-19 18:48:08
【问题描述】：

我正在使用swagger-jsdoc

我在我的 app.js 中设置了如下所示的 swagger js 文档

//include swagger js doc
var swaggerJSDoc = require('swagger-jsdoc');
const swaggerUi = require('swagger-ui-express');
const pathToSwaggerUi = require('swagger-ui-dist').absolutePath()



const swaggerDefinition = {
    swagger: '2.0',
    info: {
        // API informations (required)
        title: 'API', // Title (required)
        version: '1.0.0', // Version (required)
        description: 'Used for  api documentation', // Description (optional)
    },
    host: `localhost:3000`, // Host (optional)
    basePath: '/app/v1', // Base path (optional)
};


// Options for the swagger docs
const options = {
    // Import swaggerDefinitions
    swaggerDefinition,
    // Path to the API docs
    // Note that this path is relative to the current directory from which the Node.js is ran, not the application itself.
    apis: ['./app/v1/docs/*.yaml']
};

// Initialize swagger-jsdoc -> returns validated swagger spec in json format
const swaggerSpec = swaggerJSDoc(options);

app.use('/v1/docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));

我有一些 yaml 文件，我为记录 api 编写了这些文件。我从浏览器点击 url

localhost:3000/v1/docs

这向我展示了 swagger ui 中记录的 api。但是当我在任何 yaml 文件中进行更新并刷新页面时，我看不到更新的更改。我必须停止nodemon 进程并再次重新启动我不想这样做的进程。那么让我知道我该怎么做？

【问题讨论】：

标签： node.js swagger swagger-ui openapi nodemon

【解决方案1】：

默认情况下，nodemon 会查找扩展名为 .js、.mjs、.coffee、.litcoffee 和 .json 的文件。

要添加其他扩展，请使用以下命令： nodemon -e yaml

更多详情请参考官方文档：https://www.npmjs.com/package/nodemon

【讨论】：