跨平台开发 / 系统课时
设计位置参数与命名参数
设计位置参数与命名参数
函数参数设计决定了调用代码是简洁还是容易传错。本篇用一个可运行示例对比必填位置参数、可选位置参数和命名参数,并说明默认值与 required 的边界,最终能够根据参数含义选择更清晰的函数接口。
学习目标
- 区分必填位置参数、可选位置参数和命名参数的声明与调用方式。
- 正确使用默认值、可空类型与
required约束。 - 根据参数数量和语义选择不易误用的函数签名。
先区分三种参数
Dart 的必填位置参数直接写在参数列表中,调用者必须按顺序提供,例如 login(String user, String password)。顺序本身就是接口的一部分,所以它适合数量少、含义直观且顺序稳定的参数。
可选位置参数放在方括号 [] 中。调用时仍然只能按位置传值,只是可以省略尾部参数。命名参数放在花括号 {} 中,调用时使用 name: value 指明含义,顺序可以调整。
一个函数可以先声明必填位置参数,再选择可选位置参数或命名参数其中一种形式;不能在同一个参数列表里同时混用可选位置参数和命名参数。
用默认值处理可选参数
可选参数没有传值时必须有明确行为。对于非空类型,可直接提供默认值;默认参数值必须是编译期常量。若参数允许缺省后得到 null,则应显式使用可空类型,例如 String? prefix。
命名参数默认也是可选的。若某个命名参数在业务上必须提供,就使用 required,这样遗漏参数会在静态分析或编译阶段暴露,而不是等到函数内部再自行检查。
下面的程序同时展示三类参数。describeUser 使用必填位置参数和可选位置参数;buildMessage 使用命名参数,其中 text 是必填命名参数,repeat 有默认值。
String describeUser(String name, int age, [String role = '访客']) {
return '$name,$age 岁,角色:$role';
}
String buildMessage({
required String text,
String prefix = '提示',
int repeat = 1,
}) {
// 命名参数让调用端直接表达每个值的含义。
final line = '[$prefix] $text';
return List.filled(repeat, line).join(' | ');
}
void main() {
print(describeUser('小林', 20));
print(describeUser('小周', 28, '管理员'));
print(buildMessage(text: '保存成功'));
print(buildMessage(
text: '网络不稳定',
repeat: 2,
prefix: '警告',
));
}预期输出
小林,20 岁,角色:访客
小周,28 岁,角色:管理员
[提示] 保存成功
[警告] 网络不稳定 | [警告] 网络不稳定根据调用端选择接口
位置参数的优势是短。像 pow(base, exponent) 这类含义明确、数量少的参数,按顺序调用通常不会造成理解负担。若连续出现多个同类型值,例如布尔值、字符串或整数,调用者只看到值时就容易弄错顺序。
命名参数更适合配置型函数。调用 buildMessage(text: '网络不稳定', repeat: 2, prefix: '警告') 时,每个实参的作用直接出现在调用处,即使调整声明顺序,调用端也不必依赖记忆参数位置。
避免把可选当成随意
默认值应该表达“调用者不提供时最自然的行为”,而不是为了省事随便填一个值。若缺少参数就无法完成操作,应使用必填位置参数或 required 命名参数,而不是给一个看似可用但实际无意义的默认值。
设计接口时可以先问三个问题:这个值是否必须提供、调用者是否容易理解它的位置、缺省时是否存在合理默认行为。回答清楚后,位置参数、命名参数与默认值的选择通常就会自然确定。