Flutter/Dart中传递Map对象时如何避免引用、保护原对象不被修改

由于你的Map结构不明确且由JSON初始化，核心需求是实现深拷贝——确保新Map的所有嵌套对象都是独立的，修改新Map不会影响原Map。以下是几种实用方案：

1. JSON序列化/反序列化（最推荐，适配JSON初始化的Map） #

利用dart:convert的jsonEncode和jsonDecode，将原Map转为JSON字符串后再解析为新Map，自动断开所有嵌套引用，无需关心Map的具体结构。

import 'dart:convert';

void main() {
  Map originalMap = {
    'question': 'What is your name',
    'userInfo': {
      'age': 25,
      'hobbies': ['reading', 'coding']
    }
  };

  // 深拷贝生成新Map
  Map modifiedMap = jsonDecode(jsonEncode(originalMap));

  // 修改新Map的内容
  modifiedMap['answer'] = 'XYZ';
  modifiedMap['userInfo']['age'] = 30;
  modifiedMap['userInfo']['hobbies'].add('hiking');

  // 验证原Map未被修改
  print(originalMap['userInfo']['age']); // 输出 25
  print(originalMap['userInfo']['hobbies']); // 输出 [reading, coding]
}

适用场景：Map由JSON初始化，所有值都是JSON支持的类型（字符串、数字、布尔、List、嵌套Map等），简单高效且无需额外代码。

2. 递归深拷贝函数（处理非JSON可序列化对象） #

如果你的Map包含自定义类实例等无法被JSON序列化的对象，可手动实现递归拷贝函数，遍历所有嵌套层级并创建新对象。

Map deepCopyMap(Map original) {
  final newMap = Map.from(original);
  newMap.forEach((key, value) {
    // 递归处理嵌套Map
    if (value is Map) {
      newMap[key] = deepCopyMap(value);
    }
    // 处理嵌套List（如果List里还有Map，继续递归）
    else if (value is List) {
      final newList = List.from(value);
      for (int i = 0; i < newList.length; i++) {
        if (newList[i] is Map) {
          newList[i] = deepCopyMap(newList[i]);
        }
      }
      newMap[key] = newList;
    }
    // 基本类型（字符串、数字等）直接赋值，无需拷贝
  });
  return newMap;
}

void main() {
  Map originalMap = {
    'question': 'What is your name',
    'preferences': {
      'theme': 'dark',
      'recentSearches': [{'keyword': 'flutter'}, {'keyword': 'dart'}]
    }
  };

  Map modifiedMap = deepCopyMap(originalMap);
  modifiedMap['preferences']['recentSearches'][0]['keyword'] = 'flutter deep copy';

  // 原Map不受影响
  print(originalMap['preferences']['recentSearches'][0]['keyword']); // 输出 flutter
}

适用场景：Map包含非JSON可序列化的嵌套对象，可根据实际需求扩展函数（比如添加自定义类的拷贝逻辑）。

注意：避免浅拷贝的坑 #

像Map.from(originalMap)、Map.of(originalMap)这类方法属于浅拷贝，仅复制顶层键值对，嵌套的Map/List仍共享引用，修改嵌套对象会直接影响原Map：

Map originalMap = {'details': {'age': 25}};
Map shallowCopy = Map.from(originalMap);
shallowCopy['details']['age'] = 30;
print(originalMap['details']['age']); // 输出 30，原Map被修改！

因此浅拷贝仅适用于无嵌套结构的简单Map，你的场景务必使用深拷贝方案。

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