Flutter 向List添加新元素时所有元素均变为最新值问题求解

问题根因 #

你遇到的这个现象本质是引用传递导致的对象复用问题：Dart中对象类型的变量存储的是值的内存地址，如果你每次往variantsList中添加的是同一个对象的引用，后续修改该对象的属性时，列表中所有指向该地址的元素都会同步更新，最终表现为所有元素都等于最后一次添加的值。

典型错误写法示例 #

// 错误逻辑：全局复用同一个临时对象
Variant tempVariant = Variant();
List<Variant> variantsList = [];

// 第一次添加A
tempVariant.name = "A";
variantsList.add(tempVariant);

// 第二次添加B，修改的还是同一个对象
tempVariant.name = "B";
variantsList.add(tempVariant);

// 最终列表两个元素都指向同一个tempVariant，值全为B

修复方案 #

每次往列表中添加元素时，必须创建独立的新对象实例，不要复用同一个临时对象：

// 正确逻辑：每次添加都新建对象
List<Variant> variantsList = [];

// 第一次添加A
var variantA = Variant();
variantA.name = "A";
variantsList.add(variantA);

// 第二次添加B
var variantB = Variant();
variantB.name = "B";
variantsList.add(variantB);

// 最终列表两个元素指向不同实例，值分别为A、B符合预期

代码排查点 #

• 检查模态框提交逻辑：确认每次点击新增提交时，都重新初始化要加入列表的条目对象，不要复用类属性里定义的同一个临时变量
• 检查自定义实体类的定义：不要给存储属性加static修饰，静态属性属于类本身，所有实例共享值，也会导致所有元素同步变更
• 检查列表更新逻辑：如果你的实体类实现了copyWith方法，确认该方法是深拷贝实现，没有直接返回原对象引用
• 若你存储的是String、int等基础类型仍出现该问题，排查是否有后续遍历列表统一覆盖赋值的逻辑

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