Dart命名参数使用方法：如何强制必填命名参数？

嘿，这个问题问到点子上了！我来给你梳理清楚Dart里命名参数的用法，还有怎么把它们设为必填项——毕竟像你说的，在定义Ability这种类的时候，有些核心参数可不能漏～

在Dart中使用命名参数提升代码清晰度 #

要使用命名参数非常简单：在定义函数（包括类的构造函数）时，把需要变成命名参数的变量放在**大括号{}**里就行。

拿你提到的Ability类举例，改造后是这样的：

class Ability {
  final String name;
  final int effectDuration; // 效果持续时间
  final int recast; // 冷却时间

  // 用大括号包裹参数，变成命名参数
  Ability({
    this.name,
    this.effectDuration,
    this.recast,
  });
}

这样在实例化的时候，你可以明确指定每个参数的名称，完全不用纠结参数顺序——尤其是像effectDuration和recast这种同类型的参数，可读性直接拉满：

void main() {
  var fireball = Ability(
    name: '火球术',
    effectDuration: 5, // 一眼就知道是效果持续5秒
    recast: 10, // 冷却10秒
  );
}

为什么Dart默认让命名参数可选？ #

你说得没错，这是Dart的刻意设计：命名参数的初衷就是为了可选配置，让调用者可以只传需要的参数，避免冗余代码。比如如果你的Ability类有一些非核心属性（比如description描述），就可以设为可选的命名参数，调用时按需传递。

但如果遇到像你这种场景——某些命名参数是类的核心，必须存在——我们也有办法强制它们成为必填项。

如何强制命名参数为必填项？ #

在Dart 2.12+（空安全版本）之后，官方提供了required关键字，这是最直接的解决方案：

方法1：使用required关键字 #

在需要必填的命名参数前加上required，这样调用时如果不传这个参数，编译器会直接报错，相当于强制提醒开发者必须填写。

还是拿你的Ability类改造：

class Ability {
  final String name;
  final int effectDuration;
  final int recast;

  // 给核心参数加上required，强制必填
  Ability({
    required this.name,
    required this.effectDuration,
    required this.recast,
  });
}

现在如果实例化时漏传任何一个参数，比如Ability(name: '火球术')，编译器会立刻提示错误，确保核心参数不会被遗漏。

方法2：旧版本Dart的兼容方案（无空安全） #

如果你还在使用Dart 2.12之前的版本，可以使用@required注解（需要导入package:meta/meta.dart包），效果和required类似：

import 'package:meta/meta.dart';

class Ability {
  final String name;
  final int effectDuration;
  final int recast;

  Ability({
    @required this.name,
    @required this.effectDuration,
    @required this.recast,
  });
}

不过现在官方已经推荐使用required关键字了，除非你必须兼容旧项目，否则优先用前者。

混合使用：部分必填，部分可选 #

你还可以灵活混合必填和可选的命名参数，比如给Ability加一个可选的描述：

class Ability {
  final String name;
  final int effectDuration;
  final int recast;
  final String? description; // 可选参数，允许为null

  Ability({
    required this.name,
    required this.effectDuration,
    required this.recast,
    this.description,
  });
}

这样调用时，description可以选传，其他三个参数必须传，兼顾了灵活性和严谨性。

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