Flutter如何动态控制TextField中InputDecoration的errorText显隐

你遇到的错误提示无法隐藏问题，核心原因有两个：

• InputDecoration的errorText显示规则为：只要属性值不为null，就会持续展示错误提示。你当前代码中errText为固定值，输入合规时没有将其重置为null，因此提示无法自动消失。
• FilteringTextInputFormatter.allow仅负责拦截不符合规则的字符输入，不会自动触发错误状态更新，也无法处理空输入的校验逻辑。

核心逻辑是监听输入框内容变化，每次输入时执行规则校验，根据校验结果动态赋值errText：

• 输入内容为空时，赋值为空输入对应的错误提示文案
• 输入内容不符合0-1000整数规则时，赋值为格式错误对应的提示文案
• 输入内容完全合规时，将errText设为null，错误提示会自动隐藏

代码实现 #

1. 先添加输入监听与校验逻辑（以原生StatefulWidget为例，使用状态管理框架可直接在状态更新逻辑中复用校验规则）

// 错误文案变量，初始值为null时不显示任何提示
String? errText;

@override
void initState() {
  super.initState();
  // 给输入控制器添加内容变化监听
  state.registrySizeTxtEditCtrl.addListener(validateInput);
}

@override
void dispose() {
  // 页面销毁时移除监听，避免内存泄漏
  state.registrySizeTxtEditCtrl.removeListener(validateInput);
  super.dispose();
}

// 输入校验方法
void validateInput() {
  final input = state.registrySizeTxtEditCtrl.text.trim();
  // 校验正则和输入拦截规则保持一致
  final validRule = RegExp(r'^([0-9][0-9]{0,2}|1000)$');

  if (input.isEmpty) {
    setState(() {
      errText = "该字段不能为空";
    });
  } else if (!validRule.hasMatch(input)) {
    setState(() {
      errText = "请输入0-1000范围内的有效整数";
    });
  } else {
    // 输入合规时必须将errText设为null，才能隐藏错误提示
    setState(() {
      errText = null;
    });
  }
}

2. 原有TextField代码无需大改，保持errorText绑定动态的errText变量即可

TextField(
  controller: state.registrySizeTxtEditCtrl,
  decoration: InputDecoration(
    errorText: errText,
    enabled: state.revocation,
    labelText: 'Registry Size',
    hintText: '0 - 1000',
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(7.0),
    ),
  ),
  // 如果需要唤起系统数字键盘，请将下行替换为 keyboardType: TextInputType.number
  keyboardType: TextInputType.none,
  inputFormatters: <TextInputFormatter>[
    FilteringTextInputFormatter.allow(
        RegExp(r'^([0-9][0-9]{0,2}|1000)$')),
  ],
)

• 不要将合规状态下的errText设为空字符串""，空字符串依然会触发输入框的错误样式（红色边框），必须传null才能完全隐藏错误提示。
• 校验逻辑使用的正则规则需要和FilteringTextInputFormatter中的拦截规则保持一致，避免出现输入被拦截但校验不通过、或校验通过但输入被拦截的逻辑冲突。
• 如果不需要实时输入校验，只想在点击提交按钮时触发错误提示，无需给控制器添加监听，把校验逻辑放到表单提交的回调中执行即可。
• 如果你使用Bloc、Provider、GetX等状态管理框架，不需要编写StatefulWidget的生命周期监听，只需要在输入事件触发时更新对应状态里的errText值即可，核心判断逻辑不变。

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