Dart Flutter中如何将Widget设为默认参数？报错排查

DevOps 小满

2026-6-18

问题排查与解决方案

错误原因

Dart规定可选命名参数的默认值必须是编译时常量，你直接写Widget widget=Text('hello')时，未加const的Widget实例不是编译时常量，因此触发错误。

两种可行解决方案

方案一：使用const构造的默认Widget

如果默认Widget支持const构造（比如CircularProgressIndicator、Text），直接给默认值加上const关键字即可：

static void showFullScreenDialog({Widget widget = const CircularProgressIndicator()}) {
  showDialog(
    context: Get.overlayContext!,
    barrierDismissible: false,
    builder: (_) => PopScope(
      canPop: false,
      child: Container(
        height: double.infinity,
        width: double.infinity,
        color: Colors.transparent,
        child: Center(child: widget),
      ),
    ),
  );
}

方案二：通过空值判断设置默认Widget

如果默认Widget无法使用const构造（比如需要动态生成内容），可以将参数设为可空类型，默认值设为null，再在方法内部处理：

static void showFullScreenDialog({Widget? widget}) {
  final displayWidget = widget ?? const CircularProgressIndicator();
  
  showDialog(
    context: Get.overlayContext!,
    barrierDismissible: false,
    builder: (_) => PopScope(
      canPop: false,
      child: Container(
        height: double.infinity,
        width: double.infinity,
        color: Colors.transparent,
        child: Center(child: displayWidget),
      ),
    ),
  );
}