首页
/ Deno标准库中TOML解析器对十六进制字面量校验的缺陷分析

Deno标准库中TOML解析器对十六进制字面量校验的缺陷分析

2025-06-24 01:24:00作者:凌朦慧Richard

在Deno生态系统的标准库deno_std中,TOML解析模块目前存在一个关于数字字面量解析的规范符合性问题。该问题涉及十六进制、二进制和八进制数字字面量中下划线(_)的使用规则。

根据TOML 1.0.0规范明确规定,在数字字面量中使用下划线作为分隔符时,必须遵守特定规则:

  1. 不允许在进制前缀(如0x/0o/0b)和数字之间插入下划线
  2. 不允许在数字末尾使用下划线作为后缀
  3. 下划线只能用于数字中间作为视觉分隔符

当前deno_std的TOML解析器错误地接受了像0x_123这样的非法格式。这种格式存在两个问题:

  • 在进制前缀0x和数字123之间插入了下划线
  • 这种写法既不符合规范要求,也不符合大多数编程语言的数字字面量惯例

作为对比,主流的TOML实现如smol-toml和@iarna/toml都正确地遵循了规范,拒绝了此类非法格式。这个问题虽然看似微小,但在数据交换场景中可能导致兼容性问题,特别是当不同实现的TOML解析器对同一文档产生不同解析结果时。

对于开发者而言,应当注意:

  1. 合法的十六进制写法应为0x1230x12_34
  2. 避免在任何进制前缀后直接使用下划线
  3. 数字末尾不要使用下划线

该问题已被标记为bug并得到项目维护者的确认,预计将在后续版本中修复。在此期间,开发者在使用Deno的TOML解析功能时,应当手动检查数字字面量的格式是否符合规范,或者考虑使用其他经过验证的TOML解析器作为临时解决方案。

登录后查看全文
热门项目推荐
相关项目推荐