Flutter静态资源类分组后，常量为何无法作为默认参数？

问题场景 #

将静态颜色资源分组到子类后，使用该资源作为Widget可选参数的默认值时，会触发编译错误：The default value of an optional parameter must be constant，即使相关字段已声明为static const或final。

问题代码 #

颜色资源类：

class AppColor {
  static const _Label label = _Label();
}

class _Label {
  const _Label();
  final Color primary = const Color.fromRGBO(0, 0, 0, 1);
  final Color secondary = const Color.fromRGBO(46, 52, 58, 0.84);
}

使用资源的Widget：

class AWidget extends StatelessWidget {
  AWidget({
    super.key,
    Color color = AppColor.label.primary, 
    // 错误提示：The default value of an optional parameter must be constant
  });
  final Color color;
}

原因分析 #

核心问题是**AppColor.label.primary并非编译时常量**：

• 虽然AppColor.label是const实例，但_Label类中的primary字段仅声明为final，而非const。
• Dart中，const实例的final字段只是在实例初始化时赋值的固定值，但编译器无法将其识别为编译期常量——只有static const字段或直接的const表达式才能被确认在编译阶段就确定值。
• 直接在AppColor中声明static const Color primary = ...时，该值是直接的编译时常量，因此可以作为默认参数；但通过const实例的final字段访问时，编译器无法保证值的编译期确定性，因此报错。

解决方法 #

方法1：将子类字段改为static const #

调整子类字段为static const，这样访问的是直接的编译时常量：

class AppColor {
  static const label = _Label();
}

class _Label {
  const _Label();
  static const Color primary = Color.fromRGBO(0, 0, 0, 1);
  static const Color secondary = Color.fromRGBO(46, 52, 58, 0.84);
}

此时AppColor.label.primary属于编译时常量，可以直接作为默认参数使用。

方法2：用const getter返回常量值 #

通过getter返回const值，并在使用时显式添加const：

class AppColor {
  static const _Label label = _Label();
}

class _Label {
  const _Label();
  Color get primary => const Color.fromRGBO(0, 0, 0, 1);
  Color get secondary => const Color.fromRGBO(46, 52, 58, 0.84);
}

使用时需要将默认参数用const包裹：

class AWidget extends StatelessWidget {
  AWidget({
    super.key,
    Color color = const AppColor.label.primary,
  });
  final Color color;
}

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