Typst项目中的数值字面量解析问题分析

在Typst排版系统中，开发人员发现了一个关于非十进制数值字面量解析的问题。当用户尝试使用二进制、八进制或十六进制等非十进制格式指定长度值时，系统会错误地将这些值解析为零，而不是预期的数值。

问题现象

在Typst中，用户可以通过多种方式指定长度值。例如，以下两种写法本应产生相同的效果：

#h(0b100000pt)  # 二进制表示32磅
#h(32pt)        # 十进制表示32磅

然而实际上，二进制表示的长度值被错误地解析为0磅，导致排版结果出现异常。这个问题不仅影响二进制表示法，同样会影响八进制(0o前缀)和十六进制(0x前缀)的数值表示。

技术背景

Typst的数值解析系统在处理这类情况时存在设计缺陷。当前实现直接依赖Rust语言的原始数值解析功能，而没有对非十进制格式进行特殊处理。这与Typst对整数(Int)类型的处理方式不一致，导致了行为上的不一致性。

解决方案讨论

经过开发团队讨论，决定采取以下措施：

1. 明确不支持非十进制格式的浮点数值表示，因为：

   • 保持语言简洁性
   • 避免处理边界情况的复杂性
   • 确保行为一致性

2. 改进错误处理机制，当用户尝试使用非十进制格式时，系统将明确报错而不是静默返回零值，这有助于用户快速发现问题。

3. 对于科学计数法表示(如1e2pt)，团队认为这种表示方式更为常见和实用，决定保留支持。

对用户的影响

这一变更意味着：

• 用户不能再使用0b、0o或0x前缀表示长度、比例等数值
• 尝试使用这些格式时将收到明确的错误提示
• 科学计数法表示仍然有效

最佳实践建议

为避免问题，建议用户：

• 统一使用十进制表示法指定数值
• 对于大数值，可以使用科学计数法
• 注意系统给出的错误提示，及时调整代码

Typst团队将继续优化数值处理系统，确保其行为符合用户预期，同时保持语言的简洁性和一致性。