Flutter中能否实现让使用者必须传入其中一个命名参数？

针对你的需求，有几种实用方案可以确保使用者必须传入leadingString或leadingIcon其中一个，同时避免空安全错误：

方案一：构造函数内添加断言（开发期检查） #

在构造函数中加入断言，直接在开发阶段拦截错误传入，快速提醒使用者。这种方式改动最小，适合快速优化现有代码：

import 'package:flutter/material.dart';

class TestWidget extends StatelessWidget {
  const TestWidget({
    super.key,
    this.leadingString,
    this.leadingIcon,
  }) : assert(
         leadingString != null || leadingIcon != null,
         '必须传入leadingString或leadingIcon其中一个参数',
       );

  final String? leadingString;
  final Widget? leadingIcon;

  @override
  Widget build(BuildContext context) {
    // 断言已确保至少一个非空，可安全使用
    return ListTile(
      leading: leadingIcon ?? Text(leadingString!),
    );
  }
}

说明：断言仅在开发模式生效，发布模式会被移除，但日常开发中已能有效提醒使用者规范传参。

方案二：使用命名构造函数（语法层面强制） #

通过创建两个命名构造函数，分别对应字符串和图标场景，让使用者必须选择其中一个构造函数实例化Widget，从语法层面杜绝错误传入：

import 'package:flutter/material.dart';

class TestWidget extends StatelessWidget {
  // 私有构造函数，禁止直接使用默认构造
  const TestWidget._({
    super.key,
    required this.leading,
  });

  // 带字符串的命名构造
  TestWidget.withString({
    super.key,
    required String leadingString,
  }) : leading = Text(leadingString);

  // 带图标的命名构造
  TestWidget.withIcon({
    super.key,
    required Widget leadingIcon,
  }) : leading = leadingIcon;

  final Widget leading;

  @override
  Widget build(BuildContext context) {
    return ListTile(
      leading: leading,
    );
  }
}

使用方式：

// 传入字符串
TestWidget.withString(leadingString: '测试文本');

// 传入图标
TestWidget.withIcon(leadingIcon: Icon(Icons.home));

说明：这种方式最安全，使用者只能通过指定的命名构造函数创建实例，完全避免空参可能，代码可读性也更高。

方案三：工厂构造函数校验（保留原调用形式） #

如果想保留单个构造函数的调用形式，可通过工厂构造函数做参数校验：

import 'package:flutter/material.dart';

class TestWidget extends StatelessWidget {
  const TestWidget._({
    super.key,
    required this.leading,
  });

  factory TestWidget({
    Key? key,
    String? leadingString,
    Widget? leadingIcon,
  }) {
    assert(
      leadingString != null || leadingIcon != null,
      '必须传入leadingString或leadingIcon其中一个参数',
    );
    return TestWidget._(
      key: key,
      leading: leadingIcon ?? Text(leadingString!),
    );
  }

  final Widget leading;

  @override
  Widget build(BuildContext context) {
    return ListTile(
      leading: leading,
    );
  }
}

说明：保留了原有的命名参数调用形式，同时在工厂函数内完成参数校验和leading组件的预构建，build方法直接使用即可。

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