Flutter自定义Widget内创建的控制器如何正确dispose释放？

你最初的实现方式存在本质缺陷：

• 直接在返回组件的函数内部创建TextEditingController，每次父组件触发重建（setState、上层组件重绘等）时，textField函数会重新执行，生成全新的controller实例
• 旧的controller实例无法被外部获取，自然没法调用dispose()释放，会造成内存泄漏，还会导致已输入的内容因为实例替换意外丢失
• 这种写法完全不符合需要手动销毁的控制器类的生命周期管理要求。

你提到的「父页面创建controller，通过参数传入自定义组件」的方式完全可行，是官方推荐的标准实现方案，适合父组件需要主动读取输入内容、修改输入值、监听输入事件的场景。
参考实现：

// 父页面逻辑
class _MainPageState extends State<MainPage> {
  late final TextEditingController _inputController;

  @override
  void initState() {
    super.initState();
    _inputController = TextEditingController();
  }

  @override
  void dispose() {
    _inputController.dispose(); // 父组件销毁时统一释放控制器
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: Column(
          children: [
            customTextField(controller: _inputController),
          ],
        ),
      ),
    );
  }
}

// 自定义输入框
Widget customTextField({required TextEditingController controller}) {
  return TextFormField(
    controller: controller,
    // 其余样式、校验逻辑按需补充
  );
}

这种方案的优势是控制器生命周期完全由父组件统一管控，不会出现重建时重复生成实例的问题，父子组件之间的状态交互逻辑清晰。

如果自定义输入框不需要对外暴露输入状态，父组件完全不需要操作输入内容，就没必要把controller传给父组件。这时候不要用普通函数返回组件，要把输入框封装为独立的StatefulWidget，由组件自身的State类管理controller的创建与销毁：

class CustomTextField extends StatefulWidget {
  const CustomTextField({super.key, /* 其余样式、回调参数按需定义 */});

  @override
  State<CustomTextField> createState() => _CustomTextFieldState();
}

class _CustomTextFieldState extends State<CustomTextField> {
  late final TextEditingController _controller;

  @override
  void initState() {
    super.initState();
    _controller = TextEditingController();
    // 可按需添加输入监听逻辑
  }

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

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      controller: _controller,
      // 其余配置按需补充
    );
  }
}

这种方案封装性更好，父组件直接调用const CustomTextField()即可使用，不需要关心控制器的创建、销毁逻辑，控制器生命周期和输入框组件完全绑定，不会出现内存泄漏问题。

不要在普通组件构建函数、StatelessWidget的build方法里创建TextEditingController、ScrollController这类需要手动销毁的状态对象：这类对象的生命周期需要和组件绑定，无状态的构建逻辑每次执行都会生成新实例，既无法统一销毁，也会丢失已有的交互状态。

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