注意： Serde的数据模型将固定大小的Rust数组表示为元组（而不是列表）

RON还支持几个扩展，这些扩展的文档在此处。

规范

RON的正式和完整语法在此处。

还有一个非常基础的、正在进行中的规范在维基页面上。

为什么选择RON？

JSON中的示例

{
   "materials": {
        "metal": {
            "reflectivity": 1.0
        },
        "plastic": {
            "reflectivity": 0.5
        }
   },
   "entities": [
        {
            "name": "hero",
            "material": "metal"
        },
        {
            "name": "monster",
            "material": "plastic"
        }
   ]
}

相同的RON示例

Scene( // class name is optional
    materials: { // this is a map
        "metal": (
            reflectivity: 1.0,
        ),
        "plastic": (
            reflectivity: 0.5,
        ),
    },
    entities: [ // this is an array
        (
            name: "hero",
            material: "metal",
        ),
        (
            name: "monster",
            material: "plastic",
        ),
    ],
)

注意RON相对于JSON的优势

• 允许尾随逗号
• 单行和多行注释
• 字段名称不需要引号，因此更简洁
• 可选的结构体名称提高了可读性
• 支持枚举（并且比它们的JSON表示更简洁）

快速入门

Cargo.toml

[dependencies]
ron = "0.8"
serde = { version = "1", features = ["derive"] }

main.rs

use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
struct MyStruct {
    boolean: bool,
    float: f32,
}

fn main() {
    let x: MyStruct = ron::from_str("(boolean: true, float: 1.23)").unwrap();

    println!("RON: {}", ron::to_string(&x).unwrap());

    println!("Pretty RON: {}", ron::ser::to_string_pretty(
        &x, ron::ser::PrettyConfig::default()).unwrap(),
    );
}

工具

限制

RON不是设计成完全自描述的格式（与JSON不同），因此当使用deserialize_any而不是其类型替代品时，不能保证其工作。特别是，以下Serde属性只有有限的兼容性