在Debian系统上对Swagger API进行版本控制，通常涉及以下几个步骤：
安装Swagger工具： 首先，你需要在Debian系统上安装Swagger工具。你可以使用npm（Node.js的包管理器）来安装Swagger命令行工具。
sudo apt update
sudo apt install nodejs npm
sudo npm install -g swagger-jsdoc swagger-ui-express
创建Swagger配置文件：
在你的项目中创建一个Swagger配置文件，通常命名为swagger.json或swagger.yaml。这个文件定义了API的规范，包括路径、操作、参数、响应等。
swagger: '2.0'
info:
title: Sample API
version: 1.0.0
paths:
/users:
get:
summary: List all users
responses:
'200':
description: An array of users
集成Swagger到你的应用：
使用swagger-ui-express中间件将Swagger UI集成到你的Express应用中。
const express = require('express');
const swaggerUi = require('swagger-ui-express');
const swaggerDocument = require('./swagger.json');
const app = express();
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
app.listen(3000, () => {
console.log('Server is running on port 3000');
});
版本控制Swagger配置文件：
将swagger.json或swagger.yaml文件添加到你的版本控制系统（如Git）中。
git init
git add swagger.json
git commit -m "Initial Swagger documentation"
管理不同版本的API： 如果你需要管理不同版本的API，可以在Swagger配置文件中使用不同的版本号，并在路径中包含版本号。
swagger: '2.0'
info:
title: Sample API
version: 1.0.0
paths:
/v1/users:
get:
summary: List all users in version 1
responses:
'200':
description: An array of users
/v2/users:
get:
summary: List all users in version 2
responses:
'200':
description: An array of users with additional fields
更新Swagger文档： 每当API发生变化时，更新Swagger配置文件并提交更改到版本控制系统。
git add swagger.json
git commit -m "Update API documentation for version 2"
git push origin main
通过以上步骤，你可以在Debian系统上对Swagger API进行版本控制，并确保API文档与代码同步更新。
