toml.TomlPreserveInlineDictEncoder不生效？原理及问题排查

你遇到的问题核心是对这个编码器的功能理解有偏差：它不是将所有Python字典强制转为内联格式，而是仅保留从TOML内联字典解析而来的结构，或者将嵌套字典输出为内联形式。

关键逻辑说明 #

• TOML规范中，顶层结构默认是「表（Table）」，无论使用哪种编码器，顶层字典都会被输出为多行键值对，这是符合规范的行为。
• TomlPreserveInlineDictEncoder的设计目标是：当你从包含内联字典的TOML字符串（如parent = {a=1, b=2}）加载数据后，再dump时能还原成原来的内联格式；同时，对于嵌套在其他键下的Python字典，它会将其输出为内联字典，而非展开为子表。

正确测试示例 #

1. 嵌套字典场景

import toml

data = {'parent': {'a': 1, 'b': 2, 'c': 3}}

# 默认编码器输出（展开为子表）
print(toml.dumps(data))
# 输出:
# [parent]
# a = 1
# b = 2
# c = 3

# 使用TomlPreserveInlineDictEncoder（输出内联字典）
print(toml.dumps(data, encoder=toml.TomlPreserveInlineDictEncoder()))
# 输出:
# parent = {a = 1, b = 2, c = 3}

2. 从内联TOML加载后还原场景

import toml

# 从包含内联字典的TOML字符串加载
toml_source = "config = {host = 'localhost', port = 8080}"
data = toml.loads(toml_source)

# 使用编码器dump，保留内联格式
print(toml.dumps(data, encoder=toml.TomlPreserveInlineDictEncoder()))
# 输出:
# config = {host = "localhost", port = 8080}

关于顶层字典的处理 #

如果你想将顶层字典转为内联格式，这其实不符合TOML规范（TOML顶层不允许直接出现内联字典，必须是键值对或表）。如果非要实现，可以通过包装一层字典的方式hack：

import toml

data = {'a': 1, 'b': 2, 'c': 3}
# 包装成嵌套结构
wrapped_data = {'root': data}
# dump后去除前缀
result = toml.dumps(wrapped_data, encoder=toml.TomlPreserveInlineDictEncoder()).replace('root = ', '')
print(result)
# 输出:
# {a = 1, b = 2, c = 3}

但这种方法不建议在生产环境使用，因为不符合TOML规范，可能导致解析问题。

内容的提问来源于stack exchange，提问作者Gautitho