在 Rust 中处理 JSON：面向初学者的解析与序列化

引言：为什么 JSON 在 Rust 中很重要

JSON（JavaScript 对象表示法）是一种轻量级的数据交换格式，已成为 Web API、配置文件和服务间交互的事实标准。在 Rust（一种注重安全性和性能的系统编程语言）中，通过强大的 crate（库）生态系统来实现 JSON 处理。

尽管 Rust 不像 JavaScript 或 Python 那样内置了对 JSON 的支持，但其类型系统和内存管理方法使得 JSON 处理不仅安全，而且速度极快。在本文中，我们将探讨如何将 JSON 解析为 Rust 结构体、如何将数据序列化回 JSON，以及如何避免新手常见的错误。

在 Rust 中处理 JSON 的主要工具是 serde crate（序列化/反序列化框架）与 serde_json 配合使用。这些库提供了零成本抽象，并支持复杂的嵌套数据结构。

安装和配置依赖项

在开始之前，请创建一个新的 Rust 项目，并在 Cargo.toml 文件中添加必要的依赖项：

[dependencies]\nserde = { version = "1.0", features = ["derive"] }\nserde_json = "1.0"

serde crate 的 features = ["derive"] 标志允许使用 #[derive(Serialize, Deserialize)] 宏，这些宏会自动生成代码，用于将您的结构体转换为 JSON 以及从 JSON 转换回来。这是 Rust 的一个关键特性——您只需编写最少的样板代码，编译器就会处理繁琐的工作。

添加依赖项后，运行 cargo build 来下载并编译这些库。

将 JSON 解析为 Rust 结构体（反序列化）

创建数据模型

首先要做的是定义与您的 JSON 数据相对应的 Rust 结构体。假设我们有一个表示用户信息的 JSON：

{\n  "name": "阿列克谢",\n  "age": 30,\n  "email": "alexey@example.com",\n  "is_active": true\n}

让我们创建相应的结构体并添加序列化属性：

use serde::{Deserialize, Serialize};\n\n#[derive(Debug, Serialize, Deserialize)]\nstruct User {\n    name: String,\n    age: u32,\n    email: String,\n    is_active: bool,\n}

#[derive(Debug)] 宏允许将结构体输出到控制台以进行调试。没有它，您将无法使用 println!("{:?}", user)。

解析 JSON 字符串

现在，让我们编写一个函数，该函数接受一个 JSON 字符串并返回一个 User 结构体：

fn parse_user(json_str: &str) -> Result<User, serde_json::Error> {\n    let user: User = serde_json::from_str(json_str)?;\n    Ok(user)\n}\n\nfn main() {\n    let data = r#"\n        {\n            "name": "阿列克谢",\n            "age": 30,\n            "email": "alexey@example.com",\n            "is_active": true\n        }\n    "#;\n\n    match parse_user(data) {\n        Ok(user) => println!("用户: {:?}", user),\n        Err(e) => eprintln!("解析错误: {}", e),\n    }\n}

关键点：serde_json::from_str 会自动将 JSON 字段与结构体字段匹配。如果 JSON 中的字段名称与 Rust 中的不同（例如，JSON 使用 snake_case，而 Rust 使用 camelCase），则可以使用 #[serde(rename = "字段名")] 属性。

处理嵌套结构体

JSON 通常包含嵌套对象。考虑一个包含用户地址的示例：

{\n  "name": "阿列克谢",\n  "address": {\n    "city": "莫斯科",\n    "street": "特维尔大街",\n    "zip": "101000"\n  }\n}

让我们创建嵌套结构体：

#[derive(Debug, Serialize, Deserialize