Flutter问题：使用TextField Controller导致内容无法上推

问题原因 #

你在build方法内部创建TextFieldController（正确类名为TextEditingController，代码存在拼写错误）是核心问题。每次Widget重建时，这个局部变量会被重新实例化，导致TextField与Controller的关联状态不稳定——默认无自定义Controller时，TextField使用内部维护的稳定Controller，因此Flutter内置的“自动滚动使输入框可见”逻辑能正常触发；而自定义Controller频繁重置会打断这一逻辑，最终出现键盘遮挡输入框的情况。

解决方法 #

• 将TextEditingController声明为State类成员变量
  把Controller移至build方法外，作为State的属性，保证其生命周期与Widget一致，避免每次重建被重置：

  class _YourWidgetState extends State<YourWidget> {
    // 声明为成员变量，确保状态稳定
    final TextEditingController _textFieldController = TextEditingController();
  
    @override
    void dispose() {
      // 销毁Controller，避免内存泄漏
      _textFieldController.dispose();
      super.dispose();
    }
  
    @override
    Widget build(BuildContext context) {
      return Scaffold(
        body: SingleChildScrollView(
          child: Column(
            children: [
              Container(height: 400),
              TextField(controller: _textFieldController),
            ],
          ),
        ),
      );
    }
  }
  

• 确认Scaffold的resizeToAvoidBottomInset属性
  确保resizeToAvoidBottomInset未被设置为false（默认值为true），该属性控制页面是否为键盘腾出空间：

  Scaffold(
    resizeToAvoidBottomInset: true, // 显式声明保证生效
    // ...其他代码
  )
  

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