Flutter：仅首次Build设置TextEditingController值，避免重建时重置

核心思路是通过一个状态标记变量控制仅在首次Build时初始化控制器文本，避免每次重建覆盖用户输入，具体实现如下：

步骤1：添加初始化状态标记 #

在你的Widget State类中，新增一个布尔变量用于标记控制器是否已完成初始化：

class _YourWidgetState extends State<YourWidget> {
  final TextEditingController _controller = TextEditingController();
  bool _isControllerInitialized = false; // 标记是否已初始化控制器文本

  // ... 其他代码
}

步骤2：在Build中实现单次初始化逻辑 #

在build方法里，通过标记判断是否需要初始化控制器，同时用WidgetsBinding.instance.addPostFrameCallback避免在build过程中直接修改状态引发额外重建：

@override
Widget build(BuildContext context) {
  // 仅能在build中获取的目标字符串
  String myString = "Value only available in widget build";

  if (!_isControllerInitialized) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      setState(() {
        _controller.text = myString;
        _isControllerInitialized = true;
      });
    });
  }

  return TextField(
    keyboardType: TextInputType.number,
    inputFormatters: [FilteringTextInputFormatter.digitsOnly],
    controller: _controller,
  );
}

补充：简化实现方式 #

如果不需要严格等待帧绘制完成，也可以用Future.microtask替代postFrameCallback，效果一致：

if (!_isControllerInitialized) {
  Future.microtask(() {
    setState(() {
      _controller.text = myString;
      _isControllerInitialized = true;
    });
  });
}

注意事项 #

• 务必在State的dispose方法中销毁控制器，避免内存泄漏：

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

• 该方案仅在首次Build时设置初始值，后续Widget重建不会覆盖用户输入的内容。

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