NSwag生成客户端代码时如何将anyOf[string,null]转为可空string？

要让NSwag将anyOf[string, null]的OpenAPI定义生成string?类型的代码，需在配置中添加两个关键参数：

• 修改项目配置，在Options中追加以下参数：
  • /GenerateNullableReferenceTypes:true：启用.NET可空引用类型支持，生成符合C# 8.0+的可空语法（string?）。
  • /HandleAnyOfAsNullable:true：让NSwag识别anyOf中单一类型+null的组合，直接映射为该类型的可空版本，而非生成多余的包装类。

修改后的完整配置如下：

<ItemGroup>
  <OpenApiReference Include="OpenApis\OpenApiSpec.json" CodeGenerator="NSwagCSharp" Options="/ClientClassAccessModifier:internal /GenerateNullableReferenceTypes:true /HandleAnyOfAsNullable:true" ClassName="NSwagGeneratedClient" />
</ItemGroup>

补充说明 #

如果你的OpenAPI规范基于OpenAPI 3.0+，也可以调整Python端的生成配置，将string | None类型直接生成type: string并附加nullable: true的定义（而非anyOf），这是更标准的可空类型声明方式，NSwag对该格式支持更直接。不过通过上述NSwag配置参数，无需修改规范即可实现需求。

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