Dart中where关键字是什么？与map()有何区别？相关方法文档在哪查询？

where方法的定义与作用 #

首先需要明确：where不是Dart关键字，是Iterable接口（List、Set等集合类型都实现了该接口）的内置实例方法。
它的核心作用是按指定条件过滤集合元素：接收一个返回布尔值的测试函数作为入参，遍历集合时会将每个元素传入测试函数，仅保留返回值为true的元素，最终返回一个惰性计算的Iterable对象，只有当你遍历这个返回值时才会真正执行筛选逻辑，不会提前遍历整个集合。
示例代码：

final numbers = [1, 2, 3, 4, 5, 6];
final evenNumbers = numbers.where((num) => num % 2 == 0);
// evenNumbers 输出为 (2, 4, 6)

where与map方法的核心区别 #

• 功能差异：where是筛选集合，仅保留符合条件的元素，不会修改元素本身，返回的集合元素数量≤原集合；map是映射转换，会对集合中每一个元素执行指定转换操作，返回转换后的新元素，返回的集合元素数量和原集合完全一致
• 入参要求差异：where的入参函数必须返回bool类型，标记当前元素是否需要被保留；map的入参函数可以返回任意类型，作为新集合对应位置的元素值

对比示例：

final numbers = [1,2,3,4];
// where使用示例：筛选大于2的元素，返回2个元素
final filtered = numbers.where((e) => e > 2); // 输出 (3,4)
// map使用示例：所有元素乘2，返回4个元素
final mapped = numbers.map((e) => e * 2); // 输出 (2,4,6,8)

关联方法说明 #

• firstWhere：是基于where封装的快捷方法，会直接返回第一个符合测试条件的元素，无需遍历整个集合。如果没有符合条件的元素，默认会抛出StateError，也可以通过传入orElse参数指定无匹配时的默认返回值，示例：final firstEven = numbers.firstWhere((e) => e%2 ==0, orElse: () => -1);
• startWith：不属于Dart核心SDK的原生方法，是响应式编程扩展库RxDart为Stream类型提供的扩展方法，作用是在当前Stream的事件序列头部插入指定的初始事件值，常用于页面初始状态赋值场景
• =>箭头函数：是Dart的语法糖，仅适用于函数体只有单条返回语句的场景，(参数) => 返回值完全等价于(参数) { return 返回值; }，搭配集合操作方法使用时可以大幅简化代码写法，适合写简单的筛选、转换逻辑

官方文档查询方式 #

你可以通过以下两种方式获取所有相关方法的完整官方说明：

1. IDE内置跳转：在开发环境中对需要查询的方法执行「跳转至定义」操作，Dart SDK和第三方库的源码中都自带完整的官方注释说明，包含参数定义、返回值说明、边界场景提示和可运行的示例代码
2. 官方文档站：Dart核心库方法可以查询Dart官方SDK文档的Iterable章节，RxDart相关扩展方法可以查询RxDart官方文档对应版本的说明

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