Flutter 3中如何在同一构造函数同时使用必填参数与普通参数

Dart 作为 Flutter 的开发语言，原生支持在同一个命名参数块内混合使用required标记的必填参数和普通可选参数，不需要特殊语法做兼容，你提供的参考代码已经是这种写法的基础实现，只需要适配 Flutter 3 默认开启的空安全规则即可正常运行。

核心写法规则 #

构造函数中用大括号{}包裹所有命名参数，在需要强制传入的参数前加required关键字即可，未加该关键字的就是普通可选参数：

• 被required标记的参数：实例化组件时必须显式传入对应值，否则编译阶段直接报错
• 未被required标记的参数：实例化时可传可不传，空安全环境下要么声明为可空类型，要么提前指定默认值，否则会编译失败

代码示例 #

修正后适配Flutter 3空安全的完整组件代码 #

你提供的原始代码存在两个小问题：一是可选参数cardChild未声明可空类型/设置默认值，不符合空安全要求；二是Container的背景色写死了固定值，没有用到传入的colour参数，修正后代码如下：

class ReusableCard extends StatelessWidget {
  // 同一个大括号内同时写必填参数和可选参数
  const ReusableCard({
    super.key,
    required this.colour, // required标记的必填参数
    this.cardChild, // 普通可选参数，可空类型默认值为null
  });

  final Color colour;
  final Widget? cardChild; // 可选参数未设默认值时，类型必须加?声明为可空

  @override
  Widget build(BuildContext context) {
    return Container(
      child: cardChild,
      margin: const EdgeInsets.all(15.0),
      decoration: BoxDecoration(
        color: colour, // 改用传入的colour参数
        borderRadius: BorderRadius.circular(10.0),
      ),
    );
  }
}

如果不想让cardChild为null，也可以直接给可选参数设置非空默认值，这种情况就不需要声明可空类型：

const ReusableCard({
  super.key,
  required this.colour,
  this.cardChild = const SizedBox(), // 给可选参数设置默认空组件
});

final Color colour;
final Widget cardChild; // 有默认值就不需要加?

组件调用方式 #

命名参数不要求传入顺序和声明顺序一致，只要保证必填参数传值即可：

// 仅传必填参数，可选参数使用默认值/ null
const ReusableCard(colour: Color(0xFF1D1E33))

// 同时传必填参数和可选参数
ReusableCard(
  colour: Colors.redAccent,
  cardChild: const Center(
    child: Text(
      "卡片内容",
      style: TextStyle(fontSize: 20, color: Colors.white),
    ),
  ),
)

注意事项 #

• 大括号外的参数是位置参数，默认必填，和大括号内的命名参数不要混淆
• required只能修饰命名参数，不能修饰大括号外的位置参数
• 可选参数的传入顺序没有强制要求，只要传参时带上参数名即可

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