TOML vs YAML：为什么 Cargo 选择 TOML？

TOML vs YAML：为什么 Cargo 选择 TOML？

YAML 的问题

YAML 看起来简洁，但它有几个出了名的"坑"：

1. 语法过于复杂YAML 规范极其庞大（1.2 规范有 80+ 页），边界情况很多，不同解析器行为不一致。

2. 臭名昭著的 Norway 问题

countries:-GB-IE-NO# 被解析成 false！因为 NO = No = false

布尔值自动推断导致无数 bug。

3. 缩进敏感，容易出错

dependencies:serde:version:"1.0"features:["derive"]# 缩进差一格 = 完全不同的结构

4. 隐式类型转换

version:1.10# 变成浮点数 1.1，不是字符串 "1.10"port:080# 被当成八进制！

TOML 的优势

1. 专为配置文件设计，语义清晰、无歧义：

[package] name = "my-app" version = "1.0.0" # 明确是字符串 [dependencies] serde = { version = "1.0", features = ["derive"] }

2. 类型明确，字符串就是字符串，数字就是数字，不会魔法转换。

3. 规范简单，各平台解析结果一致，不会出现"这个 YAML 在 A 工具能用，B 工具报错"的情况。

4. 对包管理场景天然友好，表（Table）结构非常适合描述依赖关系。

简单对比

总结一句话：YAML 适合人读，但不适合机器无歧义地解析；TOML 两者兼顾，且坑少得多。