# JSON 转 C#

根据 JSON 示例为 System.Text.Json 生成 C# 类。每个属性都会添加 JsonPropertyName 特性以保留原始键名，并采用 PascalCase 命名；每个示例中都存在的键会标记为必填；可空值和可选值会使用可空类型；数组会变为 List。混合类型的值会变为 JsonElement。

## 常见问题

### 嵌套对象如何命名？

每个嵌套对象都会成为独立的 C# 类型，类型名称取自其所在键并采用 PascalCase，例如 address 会变成 Address。数组中的对象使用数组键的单数形式命名，例如 users 会变成 User。字段完全相同的对象会共用一个类型。

### 字段在什么情况下会是可选的？

如果数组包含多个对象，且某个键在部分对象中缺失，则该字段为可选字段：它没有 required 修饰符，类型也会变为可空类型。每个示例中都存在的键为必填键。单个对象没有可供比较的对象，因此其所有键都是必填键。

### 如何处理 null 值？

如果某个键在部分示例中为 null、在其他示例中有值，则该键会变为可空类型，例如 string?。如果某个键始终为 null，工具就无法据此判断其实际类型，因此会将其设为 JsonElement?；粘贴包含实际值的示例即可获得准确类型。

### 会使用哪些数字类型？

整数会变为 long，带小数的数字会变为 double。同时包含这两种数字的字段会变为 double。

### 如何处理无效名称的键？

属性名称会重新构造为 PascalCase，JsonPropertyName 特性则保留原始键名，因此 first-name 会变为 FirstName，但仍读取 first-name。若属性名称与类名相同，则会在属性名后追加数字，因为 C# 不允许两者同名。

### 我的 JSON 会被上传或存储吗？

JSON 仅会发送到服务器以便为此次请求生成代码，不会被存储。生成器只会读取示例的结构和值类型，因此你可以在粘贴前将敏感值替换为类型相同的占位值。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 通过一个 MCP 服务器为你的 AI 代理提供 433 种工具。](https://multitaskai.com/zh/?ref=oneclickpro)
