Dart中如何判断Map数组是否包含特定的Map对象

问题原因 #

Dart中默认的Map实例比较是引用比较，也就是contains方法判断元素相等时使用的==运算符，默认判断两个Map是否是同一个内存实例，而非判断键值对内容是否一致。你示例中两个{"a":1,"b":1}是独立创建的不同实例，所以contains返回false。

你当前使用的转字符串判断方案存在明显缺陷：如果两个Map的键值对内容完全一致，但存储顺序不同，toString的输出结果会不一致，会出现误判；此外字符串序列化的性能也低于直接的键值对比对。

更优解决方案 #

方案1：使用官方collection库的相等比对工具（推荐通用场景） #

这是官方维护的标准解决方案，支持普通Map比对和深层嵌套集合比对：

1. 首先在pubspec.yaml的依赖中添加：

dependencies:
  collection: ^1.18.0

2. 代码中引入后使用：

import 'package:collection/collection.dart';

void main() {
  List<Map> mapArray = [{"a":1,"b":1}];
  // 普通Map内容比对，不关心键的存储顺序
  const mapEq = MapEquality();
  final target = {"a":1,"b":1};
  final isContains = mapArray.any((item) => mapEq.equals(item, target));
  print(isContains); // 输出true

  // 如果Map存在嵌套的Map、List等结构，使用深层相等比对
  const deepEq = DeepCollectionEquality();
  final isDeepContains = mapArray.any((item) => deepEq.equals(item, target));
  print(isDeepContains); // 输出true
}

方案2：自定义Map相等判断函数（无第三方依赖） #

如果不想引入额外依赖，可以自己实现Map比对逻辑：

// 简单Map比对，仅支持值为基础类型的场景
bool simpleMapEquals(Map a, Map b) {
  if (a.length != b.length) return false;
  for (final key in a.keys) {
    if (!b.containsKey(key) || a[key] != b[key]) return false;
  }
  return true;
}

void main() {
  List<Map> mapArray = [{"a":1,"b":1}];
  final target = {"a":1,"b":1};
  final isContains = mapArray.any((item) => simpleMapEquals(item, target));
  print(isContains); // 输出true
}

注意：如果Map的值包含嵌套的集合类型，需要自行补充递归判断逻辑。

方案3：封装实体类重写相等逻辑（固定结构场景最优） #

如果你的Map结构是固定的业务字段，建议封装成实体类，重写==运算符和hashCode，此时可以直接使用contains方法，性能更高且类型安全：

class CustomData {
  final int a;
  final int b;

  CustomData({required this.a, required this.b});

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is CustomData && runtimeType == other.runtimeType && a == other.a && b == other.b;

  @override
  int get hashCode => a.hashCode ^ b.hashCode;
}

void main() {
  List<CustomData> dataList = [CustomData(a: 1, b: 1)];
  print(dataList.contains(CustomData(a: 1, b: 1))); // 输出true
}

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