Python tomllib.loads 怎么自定义浮点数类型

如果配置里的浮点数需要保留十进制语义，tomllib.loads 不必先解析成默认的 float 再二次转换。直接传入 parse_float 回调即可：回调收到每个浮点字面量的字符串，返回你希望放进结果字典的标量对象。最常用的是 decimal.Decimal，也可以返回一个带精度策略的自定义类型。

官方文档：https://docs.python.org/3/library/tomllib.html

parse_float 接管的是哪一段转换链

TOML 文档先被解析为键和值，再根据值的词法类型映射到 Python 类型。浮点值默认走 float(num_str)，而传入 parse_float 后，解析器会把每个浮点字面量的文本交给这个回调。这样做的好处是没有中间的二进制浮点阶段，金额、税率或配置阈值可以从入口就保持十进制语义。

最小用法是把 Decimal 直接作为回调。注意它必须放在关键字参数位置，不能把它当成第二个位置参数：

from decimal import Decimal
import tomllib

toml_text = "price = 19.90\nratio = 0.125\ncount = 3"

# parse_float 接收原始浮点文本，Decimal 保留十进制计算语义
config = tomllib.loads(toml_text, parse_float=Decimal)

print(type(config["price"]).__name__)  # Decimal
print(config["price"] + Decimal("0.10"))  # Decimal('20.00')
print(type(config["count"]).__name__)  # int，不会经过 parse_float

这会只改变浮点字段的 Python 类型：count 仍然是 int，字符串、布尔值、日期和表结构也继续使用标准转换。

需要统一精度时，封装一个自定义浮点标量

如果所有配置浮点都要量化到固定小数位，直接传 Decimal 还不够，因为它不会替你决定业务精度。可以让回调先创建 Decimal，再调用 quantize，或者返回一个继承自 Decimal 的业务类型。下面的函数更直观：输入仍是字符串，输出仍是单个标量。

from decimal import Decimal, ROUND_HALF_UP
import tomllib

CENT = Decimal("0.01")

def money_float(text: str) -> Decimal:
    # 统一保留两位小数，舍入规则由业务明确指定
    value = Decimal(text)
    return value.quantize(CENT, rounding=ROUND_HALF_UP)

toml_text = "unit_price = 2.675\ndiscount = 0.125"
config = tomllib.loads(toml_text, parse_float=money_float)

print(config["unit_price"])  # 2.68
print(config["discount"])   # 0.13

这个方案适合配置本身就代表金额、比例等有固定精度的字段。如果同一文件里既有金额又有科学计量值，不要用一个“全局两位小数”函数硬套所有字段；可以先全部解析为 Decimal，再依据键名做业务层校验和量化。

回调返回值和异常应该怎么处理

parse_float 的返回值要能作为普通配置值保存。官方文档明确禁止返回 dict 或 list，否则会抛出 ValueError。如果需要附带单位、来源或校验状态，建议返回不可变的自定义标量，或者在解析完成后对结果字典做第二阶段建模，不要把一整个对象树塞进浮点回调。

对于格式错误，tomllib.loads 会抛出 tomllib.TOMLDecodeError；对于自定义转换失败，可以让 Decimal 或量化逻辑的异常继续暴露，调用方再统一记录配置文件名和键路径。不要在回调里静默返回 None，否则错误会变成更晚、更难定位的业务类型错误。

常见问题

parse_float 能把整数也变成 Decimal 吗？

不能直接做到。它只处理 TOML 浮点字面量，整数仍会映射为 int。如果两类数字都要统一模型，应在解析后遍历指定字段，或调整 TOML 配置的字段约定。

能不能返回一个字典保存数值和单位？

不建议也不允许。回调返回 dict 或 list 会触发 ValueError；应返回标量，再在业务层把标量包装成带单位的对象。

为什么金额配置不推荐直接用 float？

二进制浮点不能精确表达许多十进制小数。用 Decimal 作为解析回调，可以把精度和舍入规则放在配置入口处，后续计算也更容易审计。