Flutter自定义Widget如何实现可选参数至少一个必填校验

以下是三种常用的实现方案，可根据你的项目场景选择：

• 方案1：构造函数加断言（改造成本最低）
  不需要修改现有参数结构，仅在构造函数增加断言校验，开发阶段即可快速捕获非法调用：

  class MyWidget extends StatefulWidget {
    final int? id;
    final String? username;
  
    MyWidget({this.id, this.username}) : assert(id != null || username != null, "必须传入id或username其中一个参数");
  
    // 其余原有代码不变
  }
  

  特点：调试模式下非法调用会直接抛出明确的错误提示，适合小范围快速改造。如果需要线上环境也兜底校验，可在原initState的else分支主动抛出异常。

• 方案2：命名构造函数（可读性最高）
  拆分不同初始化场景为独立的命名构造函数，从调用层面就约束参数必传，编译期即可校验合法性：

  class MyWidget extends StatefulWidget {
    final int? id;
    final String? username;
  
    MyWidget.byId({required int this.id}) : username = null;
    MyWidget.byUsername({required String this.username}) : id = null;
  
    // 其余原有代码不变
  }
  

  特点：调用方可以清晰选择对应的初始化方式，不需要额外记忆参数规则，后续新增初始化场景可直接新增命名构造函数，维护成本低。

• 方案3：联合类型约束（编译期完全安全，适合Dart 3.0+项目）
  用sealed class定义初始化参数的联合类型，从类型层面完全避免非法调用的可能，配合模式匹配不需要额外判空：

  // 定义初始化参数的联合类型
  sealed class MyWidgetInitParam {}
  class InitById extends MyWidgetInitParam {
    final int id;
    InitById(this.id);
  }
  class InitByUsername extends MyWidgetInitParam {
    final String username;
    InitByUsername(this.username);
  }
  
  // Widget定义
  class MyWidget extends StatefulWidget {
    final MyWidgetInitParam param;
    const MyWidget({required this.param});
  
    @override
    _MyWidgetState createState() => _MyWidgetState();
  }
  
  // initState中直接用模式匹配处理逻辑
  @override
  void initState() {
    super.initState();
    switch (widget.param) {
      case InitById(id: final id):
        // 基于id的初始化逻辑
        break;
      case InitByUsername(username: final username):
        // 基于username的初始化逻辑
        break;
    }
  }
  

  特点：没有任何运行时校验开销，后续新增初始化参数只需要新增sealed类的子类，扩展性极强。

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