想象一下，你平时写配置文件，TOML 明明简单易读，可市面上那些 Python 库还老是解析失败、性能拉跨、还不能优雅处理 None 值？烦不烦？今天给大家安利一个「性能炸裂」的秘密武器——rtoml，让你轻松搞定 TOML，飞一般的体验！

为什么要用 rtoml？

• • 解析正确率 100%：底层依赖稳定的 Rust 库 toml-rs，标准测试一通过，就算最刁钻的 TOML 语法也能乖乖交出结果。
• • 性能爆表：在各大 Bench 测试中，它是当之无愧的 Python TOML 解析冠军，秒杀纯 Python 实现。
• • 灵活的 None 值处理：常见库要么忽略 None，要么硬塞 null；rtoml 支持自定义 None 标记，再也不怕丢数据。
• 
  

核心功能与痛点
rtoml 主打四大操作：

• • load/loads：从文件或字符串读取 TOML，返回 dict
• • dump/dumps：将 Python 对象序列化成 TOML 文本
• • 完全兼容 json 类接口，老人上手快
• • 自定义 none_value，可选忽略或按需序列化 None

市面上那些老牌库，要么漏测、要么性能差、要么 API 不一致，让人抓狂。rtoml 一把全端覆盖，拎包即用。

安装与快速上手
只要你装了 Python 3.9+，Linux/macOS/Windows 都能 pip install rtoml。要是碰到稀奇系统没有预编译包，就得先装个 Rust Toolchain，再来一发：

# 常规安装
pip install rtoml

# 如果报错找不到 wheel：
# 先装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pip install rtoml

示例代码演示
下面演示几段常用套路，直接拷就完事儿：

import rtoml
from datetime import datetime, timezone, timedelta

# 准备一个 Python 对象
obj ={
    "title":"TOML 例子",
    "owner":{
         "name":"Tom",
         "dob": datetime(1979,5,27,7,32,tzinfo=timezone(timedelta(hours=-8))),
     },
     "data":[1,2,None,3],
}

# 序列化：忽略 None
toml_str = rtoml.dumps(obj, pretty=True, none_value=None)
print(toml_str)

# 反序列化：把 "@NONE" 当 None
cfg = rtoml.loads(toml_str, none_value="@NONE")
print(type(cfg), cfg)

优缺点对比

总结
要是你对 TOML 还停留在“老库解析报错”、“数据被吞没”、“性能太慢”的苦逼阶段，赶紧试试 rtoml。它一身正气、性能彪悍、API 又跟 json/yaml 保持统一，最重要的是对 None 值处理超灵活，配合现代 Python 项目简直太刚需。下次写配置文件，就让 rtoml 来当你的贴身保镖吧！

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。