Flutter中如何根据CheckboxListTile选择设置TextField值？附最佳实践疑问

需要实现：当CheckboxListTile被勾选时，为TextField设置一个固定值（覆盖现有内容）；取消勾选时清空TextField内容。同时想确认：在initState初始化TextEditingController后，多次在setState中重新创建新的TextEditingController实例是否属于良好实践？

你当前的做法不是良好实践，存在两个核心问题：

1. 内存泄漏风险：每次创建新的TextEditingController时，旧的实例没有被调用dispose()方法释放资源，长期下来会积累内存垃圾。
2. 不必要的组件重建：频繁替换TextField绑定的控制器，会触发组件不必要的重建，影响页面性能。

只需要维护一个TextEditingController实例，通过修改控制器的text属性来更新TextField内容，无需重复创建新实例。具体修改如下：

class _MyHomePageState extends State<MyHomePage> {
  late TextEditingController controller;
  String text = "";
  bool? _isChecked = false;

  @override
  void initState() {
    super.initState();
    controller = TextEditingController();
    // 监听控制器内容变化，同步更新text变量（可选，替代onSubmitted）
    controller.addListener(() {
      setState(() {
        text = controller.text;
      });
    });
  }

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        body: Center(
      child: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            TextField(
              controller: controller,
              // 如果不需要实时同步，可以保留onSubmitted，去掉上面的addListener
              // onSubmitted: (String value) {
              //   setState(() {
              //     text = controller.text;
              //   });
              // },
            ),
            CheckboxListTile(
              value: _isChecked,
              controlAffinity: ListTileControlAffinity.leading,
              onChanged: (bool? newValue) {
                setState(() {
                  _isChecked = newValue;
                  if (_isChecked == true) {
                    // 直接修改控制器的text属性设置默认值
                    controller.text = "Default Value 01";
                  } else {
                    // 清空TextField内容
                    controller.clear();
                  }
                  // 如果用了onSubmitted，这里需要同步更新text变量
                  // text = controller.text;
                });
              },
              title: const Text("Checkbox"),
            ),
            const SizedBox(height: 20),
            Text(text),
          ],
        ),
      ),
    ));
  }
}

关键优化点： #

• 仅在initState中创建一次TextEditingController，在dispose中统一释放资源，避免内存泄漏。
• 通过controller.text = "xxx"或controller.clear()直接更新内容，无需替换控制器实例。
• 可选添加controller.addListener()实现TextField内容与text变量的实时同步，替代onSubmitted的触发方式。

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