与其他库对比

与其他库对比¶

pyrs-yaml 与两款最流行的 Python YAML 库进行对比。

性能对比¶

解析速度（大 YAML，约 2 KB）¶

序列化速度（大 YAML，约 2 KB）¶

往返速度（大 YAML，约 2 KB）¶

功能对比¶

总结¶

选择 pyrs-yaml 的场景¶

• 性能至关重要 — 比 PyYAML 解析快 21–43 倍、序列化快 55–177 倍
• 往返保留是核心需求 — 保留注释、锚点、标签
• 需要 PyYAML 兼容性 — 即插即用 API
• 需要类型提示 — 完整 .pyi 存根
• 需要一个 wheel — ABI3 兼容 Python 3.8–3.15

选择 PyYAML 的场景¶

• 您已在使用它且不需要往返保留
• 需要与现有代码最大兼容
• 性能不是关注点

选择 ruamel.yaml 的场景¶

• 需要功能最全面的 YAML 解析器
• 正在进行复杂的 YAML 操作
• 性能不是关注点（它是三个选项中最慢的）

迁移路径¶

# 第一步：安装
pip install pyrs-yaml

# 第二步：替换导入
# 之前：
import yaml

# 之后：
import pyrs_yaml as yaml

# 第三步：测试
# 运行现有测试以验证兼容性

大多数代码无需修改即可工作。主要差异：

1. 往返输出将保留注释和格式
2. 错误消息更详细且可本地化
3. 性能将显著提升