JSON 转 Rust 生成器

如何将 JSON 转换为 Rust – 分步指南

使用此 JSON 转 Rust 生成器，可从 JSON 示例生成 Rust 结构体，适用于服务与 CLI，并可配合 serde 使用。

1. 步骤 1 – 粘贴 JSON 示例

   • 将具有代表性的 JSON 对象或数组粘贴到左侧编辑器中。
   • 尽量包含嵌套对象、数组和可为 null 的字段，方便正确推断类型。
   • 使用 导入 从文件、URL 或示例数据加载 JSON。

2. 步骤 2 – 选择 Rust 结构体选项

   • 设置根 结构体名称（例如 Root）。
   • 决定可选字段如何处理（Option<T>），未知类型如何处理（serde_json::Value）。
   • 确认命名与 serde 属性，让 JSON 键正确映射到字段。

3. 步骤 3 – 检查生成的代码

   • 确认字段命名、类型推断，以及数组/对象的映射方式是否符合预期。
   • 根据需要调整 根类型名称、空值处理策略以及可选的框架选项。
   • 如果某些字段推断不准确，优化示例 JSON 后重新生成。

4. 步骤 4 – 配合 serde 使用结构体

   • 添加 serde 与 serde_json 依赖，并启用 derive 宏。
   • 使用 serde_json::from_str 将 JSON 反序列化为根结构体。
   • 在需要更强保证时，在反序列化后做额外校验。

5. 步骤 5 – 复制或下载

   • 将输出复制到项目中，或下载为文件。
   • 运行格式化/代码检查工具，让代码风格与项目保持一致。
   • 若目标语言需要序列化/解析库，请在项目中添加相应依赖。

// JSON 输入
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// 生成的 Rust 结构体（简化）
use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize)]
pub struct Metadata {
  pub plan: String,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct Root {
  pub id: i64,
  pub name: String,
  pub email: Option<String>,
  pub active: bool,
  pub roles: Vec<String>,
  pub metadata: Metadata,
  pub createdAt: String,
  pub score: f64,
  pub notes: serde_json::Value,
}

相关 JSON 与 Rust 工具

探索更多可与本 JSON 转 Rust 生成器配合使用的 JSON 与 Schema 工具。