如何将 Swagger 添加到我的 Azure 云服务工作者角色

【问题标题】：How would I add Swagger to my Azure cloud service worker role如何将 Swagger 添加到我的 Azure 云服务工作者角色
【发布时间】：2026-02-05 12:50:01
【问题描述】：

我有一个 Azure 云服务（辅助角色）正在运行。此辅助角色使用 WebHttpBinding 绑定公开 Web 端点。它使用 WebInvoke 公开了几个 REST 端点。

例子：

[OperationContract]
[WebInvoke(UriTemplate = "/Test",
    Method = "GET",
    RequestFormat = WebMessageFormat.Json,
    ResponseFormat = WebMessageFormat.Json)]
bool Test();

我需要在哪里或如何开始将 Swagger UI 添加到我的项目中，以便外部开发人员可以查看我的 API 上的文档？

任何帮助表示赞赏。我正在使用 .NET 4.5.2 和 C#

【问题讨论】：

标签： c# api azure swagger

【解决方案1】：

目前有两个 Nuget 包 -

Core 库 (Swashbuckle.Core) 和提供自动引导的便利包 (Swashbuckle)。

后者仅适用于常规 IIS 托管的 WepApi。对于所有其他托管环境，您应该只安装 Core 库，然后按照以下说明手动启用 Swagger 路由。

安装并启用后，您应该能够分别浏览以下 Swagger 文档和 UI 端点：

“你的根网址”/swagger/docs/v1

“你的根网址”/swagger

这里是这个项目的完整参考的 github 页面： https://github.com/domaindrivendev/Swashbuckle

【讨论】：

谢谢！我会检查一下，并就此事与您联系。非常感谢。