在Ubuntu系統中，使用Swagger調試代碼的核心流程是安裝Swagger工具→配置Swagger文檔→啟動服務并測試接口→結合調試工具排查問題。以下是詳細步驟：
在Ubuntu上使用Swagger前，需安裝以下工具：
sudo apt update
sudo apt install -y nodejs npm
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
Swagger UI是調試API的主要可視化工具，以下是三種常見安裝方式：
# 全局安裝swagger-ui-express
sudo npm install -g swagger-ui-express
這種方式需結合Express框架使用，適合已有Node.js項目的場景。
# 拉取Swagger UI鏡像
docker pull swaggerapi/swagger-ui
# 運行容器（將本地swagger.json掛載到容器內）
docker run -p 8080:8080 -v /path/to/your/swagger.json:/usr/share/nginx/html/swagger.json swaggerapi/swagger-ui
訪問http://localhost:8080即可查看Swagger UI（需將/path/to/your/swagger.json替換為實際路徑）。
# 下載Swagger Editor
wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
tar -xvf v3.16.1.tar.gz
cd swagger-editor-3.16.1
# 安裝依賴并啟動
npm install
npm install -g http-server
http-server -p 8080
訪問http://localhost:8080，可通過界面編輯或導入Swagger文檔（如swagger.yaml/swagger.json）。
Swagger調試需基于API規范文檔（支持YAML或JSON格式）。以下是一個簡單的swagger.yaml示例：
swagger: '2.0'
info:
title: Sample API
description: A demo API for Swagger debugging
version: 1.0.0
basePath: /
paths:
/users:
get:
summary: Get all users
responses:
'200':
description: A list of users
schema:
type: array
items:
$ref: '#/definitions/User'
definitions:
User:
type: object
properties:
id:
type: integer
name:
type: string
將文檔保存為swagger.yaml（或swagger.json），并放置在項目根目錄。
若使用Node.js框架（如Express），需將Swagger UI集成到應用中，實現文檔與接口的聯動：
const express = require('express');
const swaggerUi = require('swagger-ui-express');
const YAML = require('yamljs');
const app = express();
const port = 3000;
// 加載Swagger文檔
const swaggerDocument = YAML.load('./swagger.yaml');
// 集成Swagger UI（訪問/api-docs查看）
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
// 示例接口（需與Swagger文檔一致）
app.get('/users', (req, res) => {
res.json([{ id: 1, name: 'John Doe' }, { id: 2, name: 'Jane Smith' }]);
});
app.listen(port, () => {
console.log(`Server running at http://localhost:${port}`);
});
運行應用：
node app.js
訪問http://localhost:3000/api-docs，即可看到Swagger UI界面，其中包含/users接口的定義。
在Swagger UI界面中，調試接口的步驟如下：
/users的GET方法），點擊右側的Try it out按鈕。200，說明接口正常；404、500），需檢查Swagger文檔與接口實現的一致性（如路徑、參數類型）或后端代碼邏輯。使用Visual Studio Code調試：
若需更深入的調試（如查看變量、斷點調試），可通過VS Code配置Node.js調試：
.vscode/launch.json文件：{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug Swagger App",
"program": "${workspaceFolder}/app.js",
"skipFiles": ["<node_internals>/**"]
}
]
}
F5，啟動調試模式；自定義Swagger UI：
若需修改Swagger UI樣式或添加自動授權功能，可在node_modules/swagger-ui-dist目錄下創建custom.js文件，編寫自定義腳本（如自動添加Token）：
window.onload = function() {
const token = 'your_access_token';
SwaggerUIBundle.authActions.authorize({
token: { value: token }
});
};
然后在集成Swagger UI時注入該腳本：
app.use('/api-docs', swaggerUi.serve, (req, res, next) => {
req.swaggerUiOptions.injectJavascript = '/path/to/custom.js';
next();
}, swaggerUi.setup(swaggerDocument));
通過以上步驟，你可以在Ubuntu系統中使用Swagger完成API文檔的可視化、接口測試及調試。若遇到問題，可檢查Swagger文檔的語法（如YAML縮進）、接口實現的路徑與文檔是否一致，或通過調試工具定位具體錯誤。
