跨平台开发 / 系统课时

设计位置参数与命名参数

设计位置参数与命名参数

函数参数设计决定了调用代码是简洁还是容易传错。本篇用一个可运行示例对比必填位置参数、可选位置参数和命名参数,并说明默认值与 required 的边界,最终能够根据参数含义选择更清晰的函数接口。

学习目标

  • 区分必填位置参数、可选位置参数和命名参数的声明与调用方式。
  • 正确使用默认值、可空类型与 required 约束。
  • 根据参数数量和语义选择不易误用的函数签名。

先区分三种参数

Dart 的必填位置参数直接写在参数列表中,调用者必须按顺序提供,例如 login(String user, String password)。顺序本身就是接口的一部分,所以它适合数量少、含义直观且顺序稳定的参数。

可选位置参数放在方括号 [] 中。调用时仍然只能按位置传值,只是可以省略尾部参数。命名参数放在花括号 {} 中,调用时使用 name: value 指明含义,顺序可以调整。

一个函数可以先声明必填位置参数,再选择可选位置参数或命名参数其中一种形式;不能在同一个参数列表里同时混用可选位置参数和命名参数。

用默认值处理可选参数

可选参数没有传值时必须有明确行为。对于非空类型,可直接提供默认值;默认参数值必须是编译期常量。若参数允许缺省后得到 null,则应显式使用可空类型,例如 String? prefix。

命名参数默认也是可选的。若某个命名参数在业务上必须提供,就使用 required,这样遗漏参数会在静态分析或编译阶段暴露,而不是等到函数内部再自行检查。

下面的程序同时展示三类参数。describeUser 使用必填位置参数和可选位置参数;buildMessage 使用命名参数,其中 text 是必填命名参数,repeat 有默认值。

dart
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: '警告',
  ));
}

预期输出

text
小林,20 岁,角色:访客
小周,28 岁,角色:管理员
[提示] 保存成功
[警告] 网络不稳定 | [警告] 网络不稳定

根据调用端选择接口

位置参数的优势是短。像 pow(base, exponent) 这类含义明确、数量少的参数,按顺序调用通常不会造成理解负担。若连续出现多个同类型值,例如布尔值、字符串或整数,调用者只看到值时就容易弄错顺序。

命名参数更适合配置型函数。调用 buildMessage(text: '网络不稳定', repeat: 2, prefix: '警告') 时,每个实参的作用直接出现在调用处,即使调整声明顺序,调用端也不必依赖记忆参数位置。

避免把可选当成随意

默认值应该表达“调用者不提供时最自然的行为”,而不是为了省事随便填一个值。若缺少参数就无法完成操作,应使用必填位置参数或 required 命名参数,而不是给一个看似可用但实际无意义的默认值。

设计接口时可以先问三个问题:这个值是否必须提供、调用者是否容易理解它的位置、缺省时是否存在合理默认行为。回答清楚后,位置参数、命名参数与默认值的选择通常就会自然确定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计位置参数与命名参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通