如何从WSDL/XML生成OpenAPI Swagger YAML？求.NET C#相关库

一、WSDL转OpenAPI（Swagger）的工具 #

不用自己从头写代码，有不少成熟工具可以直接用：

• wsdl2openapi：这是个npm包，命令行工具，专门做WSDL到OpenAPI 3.0的转换。安装后直接跑命令就能生成YAML/JSON格式的OpenAPI文档，步骤大概是：

  npm install -g wsdl2openapi
  wsdl2openapi your-service.wsdl -o openapi-output.yaml
  

• Swagger Editor：在线版或者本地部署的Swagger Editor都支持直接导入WSDL文件，它会自动解析并转换成OpenAPI格式，你还能在编辑器里实时调整生成的内容，很方便。
• OpenAPI Generator：这个工具功能更全，不仅能转WSDL到OpenAPI，还能生成各种语言的客户端/服务端代码。转换命令示例：

  openapi-generator generate -i your.wsdl -g openapi-yaml -o ./openapi-docs
  

二、从给定XML生成Swagger 3.0 YAML是否需要自定义代码？ #

看你的具体需求：

• 如果只是生成schema部分（比如示例里的Country和Countries结构），可以先用XML转JSON Schema的工具把你给的XML转换成JSON Schema，再导入到Swagger Editor里，它会自动映射成OpenAPI的schema组件，然后你手动补充info、paths这些框架部分就行，不需要写自定义代码。
• 如果要完全程序化、自动化生成整个OpenAPI文档（包括paths、responses等所有部分），那确实需要写自定义代码。比如用C#或者Python读取XML节点，然后对应构建OpenAPI的YAML结构——比如你给的XML里的<name>对应schema里的name: string，<population>对应population: integer，遍历XML节点就能完成映射。

三、.NET C#中类似XMLDocument的YAML操作库 #

推荐两个常用的，都支持像操作XML节点一样手动构建YAML文档：

• YamlDotNet：这是.NET生态里最流行的YAML库，API设计很友好。你可以用它的节点类（比如YamlMappingNode、YamlSequenceNode）像拼XML节点一样一步步构建YAML结构，示例代码：

  using YamlDotNet.RepresentationModel;
  using System.IO;
  
  var yamlStream = new YamlStream();
  var root = new YamlMappingNode();
  
  // 添加openapi版本和info节点
  root.Add("openapi", "3.0.0");
  var info = new YamlMappingNode();
  info.Add("version", "1.0.0");
  info.Add("title", "SysCountry");
  root.Add("info", info);
  
  // 继续添加servers、paths、components等节点...
  
  yamlStream.Add(new YamlDocument(root));
  
  // 保存到字符串或文件
  using var writer = new StringWriter();
  yamlStream.Save(writer, false);
  string yamlContent = writer.ToString();
  

• SharpYaml：轻量型的YAML库，同样支持节点式操作，适合构建复杂的YAML文档，API风格和XMLDocument类似，上手很快。

内容的提问来源于stack exchange，提问作者sandunes90