Dart SDK 3.6 数字分隔符格式化问题解析

背景介绍

在 Dart 3.6 版本中，语言引入了一个实用的新特性：数字分隔符。这个特性允许开发者在书写大数字时使用下划线(_)来提高可读性，例如可以将数字 6000 写成 6_000。这个特性在官方文档中已有明确说明，属于 Dart 3.6 的标准功能。

问题现象

然而，当开发者使用 dart format 命令格式化包含数字分隔符的代码时，会遇到一个奇怪的问题。格式化工具会报错提示需要启用实验性功能标志，尽管数字分隔符已经是稳定版本的标准功能。

具体表现为运行以下命令时：

dart format .

会收到错误信息：

This requires the 'digit-separators' language feature to be enabled.

临时解决方案

目前开发者需要添加 --enable-experiment=digit-separators 标志才能成功格式化代码：

dart format --enable-experiment=digit-separators .

有趣的是，当使用这个标志时，系统会提示：

'digit-separators' is now enabled by default; this flag is no longer required.

这表明数字分隔符功能实际上已经默认启用，但格式化工具却仍然要求显式启用这个标志，这显然是一个不一致的行为。

技术分析

这个问题本质上是一个工具链的同步问题。虽然 Dart 3.6 的语言规范已经将数字分隔符作为标准功能，但相关的格式化工具(dart format)的实现还没有完全跟上这个变化。这导致了工具仍然将这个功能视为需要显式启用的实验性功能。

这种问题在语言演进过程中并不罕见，特别是当新功能从实验阶段过渡到稳定阶段时，工具链的不同部分可能会以不同的速度进行更新。

解决方案

根据问题跟踪情况，Dart 团队已经通过 cherrypick 方式修复了这个问题。这意味着：

1. 在未来的 Dart SDK 版本中，dart format 将能够正确处理数字分隔符而无需任何特殊标志
2. 修复已经向后移植到相关版本分支，确保现有用户也能获得修复

最佳实践建议

对于当前使用 Dart 3.6 的开发者：

1. 如果遇到格式化问题，可以暂时使用 --enable-experiment=digit-separators 标志
2. 关注 Dart SDK 的更新，及时升级到包含修复的版本
3. 在团队协作中，可以统一代码风格，决定是否使用数字分隔符特性

总结

Dart 的数字分隔符是一个提高代码可读性的实用功能。虽然工具链的同步问题暂时影响了开发体验，但这个问题已经得到解决。这提醒我们，在使用新语言特性时，有时需要关注工具链的支持情况，并在必要时采用临时解决方案。随着 Dart 生态系统的持续完善，这类问题将越来越少。