Flutter中ValueKey为何未阻止TestWidget重复重建？

核心原因是Flutter判断是否需要触发子组件build的逻辑，不仅依赖Key，还会对比新旧Widget实例是否"相等"，你的两种写法在这一点上有本质区别：

1. 用const创建Widget时不重建的原因 #

当你用const TestWidget("1")创建组件时，这些是编译时常量，每次调用_loadTestWidgets返回的都是同一个Widget实例。Flutter对比父组件重建前后的子Widget时，发现是同一个引用，会直接判定"没有变化"，因此不会触发子组件的build。

2. 循环创建带ValueKey的Widget时重建的原因 #

你循环创建的TestWidget每次都是新的实例，哪怕Key和datasetId的值完全相同：

• 首先，TestWidget的构造函数没有标记为const，所以即使参数一致，每次都会生成新的对象；
• 其次，Flutter中StatefulWidget默认的==运算符是引用比较，只要是不同实例，就会被判定为"不相等"；
• ValueKey的作用是帮助Flutter在Widget树中找到对应的State实例（避免重新创建State），但它不会改变Widget实例的相等性判断逻辑。所以哪怕State被复用，只要新旧Widget被判定为不相等，Flutter就会触发子组件的build方法。

解决方法 #

要避免这种不必要的重建，有两种可行方案：

方案一：重写Widget的相等性判断 #

给TestWidget重写==运算符和hashCode，让Flutter根据实际属性（Key、datasetId）来判断Widget是否相等：

class TestWidget extends StatefulWidget {
  final String datasetId;
  const TestWidget(this.datasetId, {super.key});

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is TestWidget &&
          runtimeType == other.runtimeType &&
          key == other.key &&
          datasetId == other.datasetId;

  @override
  int get hashCode => Object.hash(runtimeType, key, datasetId);

  @override
  State<StatefulWidget> createState() => TestWidgetState();
}

这样只要Key和datasetId不变，即使生成新的Widget实例，Flutter也会判定为"相等"，不会触发build。

方案二：缓存Widget实例 #

如果datasetId的集合不会动态变化，可以提前缓存TestWidget实例，而不是每次调用_loadTestWidgets都重新创建：

final List<TestWidget> _cachedWidgets = [
  TestWidget(key: const ValueKey("test-widget-0"), "0"),
  TestWidget(key: const ValueKey("test-widget-1"), "1"),
  TestWidget(key: const ValueKey("test-widget-2"), "2"),
];

List<TestWidget> _loadTestWidgets() {
  return _cachedWidgets;
}

这样每次返回的都是同一个实例，和用const的效果一致。

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