如何解决Dart空安全下可选命名参数的空值报错问题

报错根因 #

你遇到的报错：

参数'namePerson'的类型不允许为null，但其隐式默认值为null

核心原因是Dart 2.12+空安全规则限制：所有非空类型的变量必须被初始化，而用{}包裹的命名参数默认是可选的，调用方如果不传参数，参数值就会是null，和你定义的非空String类型冲突。

报错原始代码：

void main() {     
  greet(greeting: 'Hey', namePerson: 'Cindy');
}

void greet({String namePerson, String greeting}){
  print("$greeting $namePerson");
}

三种修复方案的逻辑与适用场景 #

• 方案1：类型后添加?声明为可空类型
  写法示例：void greet({String? namePerson, String? greeting})
  逻辑：声明该参数允许接收null值，和可选命名参数的默认null值兼容。
  适用场景：参数确实是可选的，业务逻辑允许该参数为空，使用参数前你可以自行做空判断处理，比如打印时写${namePerson ?? '访客'}给空值兜底。
• 方案2：参数前加required关键字
  写法示例：void greet({required String namePerson, required String greeting})
  逻辑：强制要求调用方必须传入该参数，参数永远不会出现null值，符合非空类型要求。
  适用场景：该参数是函数正常运行的必要条件，没有合理的默认值，不传就会导致业务逻辑错误，优先选这个方案。
• 方案3：给参数设置固定默认值
  写法示例：void greet({String namePerson = 'Bob', String greeting = '你好'})
  逻辑：如果调用方不传该参数，自动使用你预设的默认值，参数永远不会为null。
  适用场景：参数有明确的通用默认值，大部分调用场景不需要自定义该参数，用默认值就能满足需求，能简化调用方的代码。

方案选择判断顺序 #

1. 先判断参数是否是业务必需项，是就选required
2. 不是必需项，看是否有通用默认值，有就选设置默认值
3. 既不是必需也没有合适默认值，再选声明为可空类型，同时做好空值处理

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