如何在Dart构建阶段执行断言？16位字符串常量校验场景求解

场景与问题 #

在constants.dart文件中定义String常量，要求其长度必须为16个字符，示例代码如下：

const String myConstant = 'My_16_characters';

但直接使用assert(myConstant.length == 16)无法生效——因为断言必须放在main()函数中，而当该文件作为库导入Flutter项目时，这个main()永远不会执行。

问题解答 #

global_assert并非首选方案 #

global_assert不是官方维护的库，存在版本兼容性、长期维护风险，且完全可以用原生Dart特性实现相同效果，没必要依赖它。

无需第三方库的替代方案 #

1. 编译期const构造函数封装（最推荐）

自定义一个带const构造函数的类，在构造时嵌入长度校验，错误会在编译阶段直接抛出：

class Fixed16LengthString {
  final String value;
  const Fixed16LengthString(this.value) : assert(value.length == 16, "字符串长度必须为16");
}

// 定义常量时使用该类
const myConstant = Fixed16LengthString('My_16_characters');
// 使用时取value属性：myConstant.value

只要常量长度不符合要求，编译时就会报错，完全不需要依赖main()执行断言。

2. const校验函数（轻量方案）

用const函数封装校验逻辑，同样能在编译期触发断言：

const String _validate16Length(String input) {
  assert(input.length == 16, "字符串长度必须为16");
  return input;
}

// 定义常量时调用校验函数
const String myConstant = _validate16Length('My_16_characters');

这种方案不需要额外定义类，代码更简洁，同样能在编译阶段拦截不符合要求的常量。

3. 单元测试兜底

虽然上面两种方案能在编译期校验，但单元测试可以作为补充，确保常量在任何场景下都符合要求：

import 'package:test/test.dart';
import 'constants.dart';

void main() {
  test('myConstant长度必须为16', () {
    expect(myConstant.length, equals(16));
  });
}

关于类型层面的校验 #

Dart没有TypeScript那样的字面量类型（比如String<16>），但通过上面的const构造函数或const校验函数，已经能实现接近类型层面的编译期约束，满足你的需求。

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