如何基于OpenAPI定义生成Visual Basic .NET客户端？

以下是经过验证可落地的实现路径，按操作复杂度从低到高排列：

• 方案1：使用OpenAPI Generator直接生成VB客户端
  不要用Swagger Editor的在线生成功能，它的VB模板长期未维护且不支持老框架配置。使用OpenAPI Generator命令行工具执行生成时，指定语言参数为visualbasic，额外传入配置项：targetFramework=net35、restSharpVersion=106.15.0（该版本是RestSharp最后一个兼容.NET 3.5的稳定版）、newtonsoftVersion=12.0.3（Newtonsoft.Json兼容.NET3.5的稳定版本）。生成完成后将输出的所有.vb源码文件直接导入你的项目，再通过NuGet安装对应版本的依赖即可，生成的代码默认已经处理了请求序列化、响应反序列化、异常处理逻辑，可直接调用。
• 方案2：C#生成后转译/引用，规避VB模板缺陷
  由于C#的OpenAPI客户端模板成熟度远高于VB模板，可以先生成兼容.NET3.5的C#客户端：生成时选择基于HttpWebRequest或老版本RestSharp的模板，确认生成的C#代码在.NET3.5的C#类库项目中可正常编译、接口调通后，有两种使用方式：
  • 直接在VB项目中引用编译好的C#类库dll，不需要转成VB代码，.NET跨语言调用完全兼容，没有额外适配成本
  • 如果需要纯VB源码，用ILSpy等反编译工具将编译通过的C# dll直接反编译为VB.NET代码，反编译输出的代码完整度远高于VS“粘贴JSON生成类”的结果，仅需微调个别命名冲突即可直接使用
• 方案3：轻量手动封装（适合接口量少的场景）
  如果需要调用的API接口数量少于20个，不需要生成全量客户端，直接基于.NET 3.5原生的HttpWebRequest写一个通用的请求发送/响应反序列化方法，再对照OpenAPI yaml里的schema定义，手动编写需要用到的请求、响应模型类即可。不要使用VS自带的“粘贴JSON为类”功能，该功能对复杂嵌套、枚举、泛型类型的识别错误率极高，反而会增加排错成本。

避坑提示：所有生成配置都要避开依赖HttpClient、System.Text.Json的选项，这两个组件在.NET Framework 3.5中不存在，生成的代码必然编译失败；所有第三方依赖都要选择明确支持.NET Framework 3.5的版本，不要安装最新版。

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