koa2 安装swagger

要在 Koa2 中使用 Swagger，您需要安装以下两个 npm 包：

1. swagger-jsdoc：它允许您使用 JSDoc 注释编写 OpenAPI 规范。
2. swagger-ui-dist：它提供了 Swagger UI 的前端部分，它允许您可视化展示和测试 API。

您可以使用以下命令来安装它们：

npm install swagger-jsdoc swagger-ui-dist --save

安装完成后，您可以按照以下步骤进行设置：

1. 创建一个 Swagger 规范文件，例如 swagger.json 或 swagger.yaml。
2. 在 Koa2 应用程序中导入 swagger-jsdoc 包，并将 Swagger 规范文件路径传递给 swaggerJSDoc() 函数。
3. 使用 koa-static 中间件为 swagger-ui-dist 提供静态资源。
4. 创建一个 Koa 路由来处理 Swagger UI 的请求，并使用 send() 方法将 index.html 文件发送到客户端。

以下是一个示例代码：

const Koa = require('koa');
const Router = require('koa-router');
const serve = require('koa-static');
const swaggerJSDoc = require('swagger-jsdoc');

const app = new Koa();
const router = new Router();

// Swagger specification
const swaggerDefinition = {
  info: {
    title: 'My API',
    version: '1.0.0',
    description: 'My API documentation',
  },
  host: 'localhost:3000',
  basePath: '/',
};

const swaggerOptions = {
  swaggerDefinition,
  apis: ['./routes/*.js'], // Path to the API docs
};

const swaggerSpec = swaggerJSDoc(swaggerOptions);

// Serve swagger-ui-dist
app.use(serve(__dirname + '/node_modules/swagger-ui-dist'));

// Swagger UI route
router.get('/api-docs', async (ctx) => {
  ctx.set('Content-Type', 'text/html');
  ctx.body = swaggerSpec;
});

app.use(router.routes());

app.listen(3000);

在这个示例中，我们将 swaggerDefinition 对象传递给 swaggerJSDoc() 函数，它返回一个 Swagger 规范对象。我们还将路由文件的路径传递给 swaggerOptions 对象的 apis 属性，以便 swagger-jsdoc 可以解析 JSDoc 注释并生成 Swagger 规范。

注意，我们还使用了 koa-static 中间件来提供 swagger-ui-dist 的静态资源。最后，我们创建了一个路由来处理 Swagger UI 的请求，并使用 send() 方法将 index.html 文件发送到客户端。

现在，您可以在浏览器中访问 http://localhost:3000/api-docs 来查看 Swagger UI。