Linux下Swagger文檔如何進行國際化處理

Swagger 本身是一個 API 文檔生成和測試工具，它并不直接提供多語言支持。但是，您可以在 Swagger UI 中顯示和操作多種語言的 API 文檔。要實現這一點，您需要為每種語言生成相應的 Swagger JSON 文件，然后在 Swagger UI 中導入這些文件。

生成不同語言的 Swagger JSON 文件

您可以使用 swagger-codegen 工具為不同的編程語言生成 Swagger JSON 文件。例如，如果您有一個使用 Python 編寫的 API，您可以使用以下命令為 Python 生成 Swagger JSON 文件：

swagger-codegen generate -i your-api-spec.yaml -l python -o output-directory

同樣，您可以為其他語言（如 Java、Node.js 等）生成 Swagger JSON 文件。

在 Swagger UI 中導入多語言文件

生成的 Swagger JSON 文件可以導入到 Swagger UI 中，以便查看和測試不同語言的 API 文檔。在 Swagger UI 中，您需要為每種語言提供一個單獨的 JSON 文件，并在 UI 中導入這些文件。

啟用 Swagger UI 的多語言支持

在某些情況下，您可能需要在 Swagger UI 中啟用多語言支持。例如，在 C# 中使用 Swashbuckle.AspNetCore 庫時，您可以在 Startup.cs 文件中配置 Swagger UI 以啟用多語言支持：

app.UseSwaggerUI(options =>
{
    options.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    options.EnableTranslate(); // 啟用多語言支持
    options.EnableTryItOutByDefault();
    options.UseRequestInterceptor("(req) { req.headers['Accept-Language'] = 'zh-CN'; return req; }"); // 設置默認語言
});

此外，您需要下載 Swagger UI 的多語言支持文件，并將其放入項目的 wwwroot 文件夾中。您可以從 Swagger UI 的 GitHub 倉庫 下載所需的多語言文件。

注意事項

• 雖然 Swagger UI 支持多種語言的 API 文檔，但實際的 API 調用仍然需要使用相應語言的客戶端庫或工具。例如，如果您在 Swagger UI 中查看了一個 Python API，您仍然需要使用 Python 客戶端庫來實際調用 API。

通過以上步驟，您可以在 Linux 下的 Swagger 文檔中進行國際化處理，從而為用戶提供多語言的支持。