如何正确释放ListView中使用的TextEditingController，避免延迟销毁的hack方案

问题根本原因 #

移除列表元素时如果立即销毁控制器，Flutter当前帧的渲染流程尚未执行完成，被删除的列表项对应的TextField在当前帧渲染时仍会访问已销毁的控制器，因此抛出异常。延迟销毁的方案本质是等待渲染流程结束，但硬编码的延迟时间不可靠，不同设备的渲染耗时存在差异，属于不稳定的hack方案。

正确解决方案 #

方案1：使用帧结束回调销毁（适合需要外层持有控制器的场景）

利用Flutter官方提供的addPostFrameCallback回调，该回调会在当前帧所有渲染逻辑执行完成后触发，此时被删除的列表项已经不会再被访问，可以安全销毁控制器。

final controller = stropheForms[index].controller;
setState(() {
  stropheForms.removeAt(index);
});
// 当前帧渲染完成后再销毁控制器
WidgetsBinding.instance.addPostFrameCallback((_) {
  controller.dispose();
});

方案2：将控制器生命周期绑定到列表项组件（推荐，符合Flutter设计规范）

把每个表单项抽离为独立的StatefulWidget，控制器在列表项的initState中创建，在列表项的dispose生命周期中自动销毁。当删除列表项时，Flutter会自动触发对应列表项组件的销毁流程，控制器会被安全释放，完全不需要手动管理销毁时机。

// 抽离独立的表单项组件
class StropheFormItem extends StatefulWidget {
  final StropheForm formData;
  final VoidCallback onDelete;

  const StropheFormItem({
    super.key,
    required this.formData,
    required this.onDelete,
  });

  @override
  State<StropheFormItem> createState() => _StropheFormItemState();
}

class _StropheFormItemState extends State<StropheFormItem> {
  late TextEditingController _controller;

  @override
  void initState() {
    super.initState();
    _controller = TextEditingController(text: widget.formData.content);
    // 可按需添加监听同步值到外层
    _controller.addListener(() {
      widget.formData.content = _controller.text;
    });
  }

  @override
  void dispose() {
    // 组件销毁时自动释放控制器
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Row(
      children: [
        Expanded(child: TextField(controller: _controller)),
        IconButton(
          icon: const Icon(Icons.delete, color: Colors.red),
          onPressed: widget.onDelete,
        ),
      ],
    );
  }
}

// 外层ListView使用示例
ListView.builder(
  itemCount: stropheForms.length,
  itemBuilder: (context, index) {
    return StropheFormItem(
      formData: stropheForms[index],
      onDelete: () {
        setState(() {
          stropheForms.removeAt(index);
        });
      },
    );
  }
)

该方案符合组件封装原则，控制器和对应组件的生命周期完全绑定，不会出现生命周期不同步的问题，后期维护成本更低。

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