Flutter中TextFormField的TextCapitalization.words在Android端失效求助

问题描述 #

使用textCapitalization: TextCapitalization.words配置TextFormField时，iOS端可正常实现每个单词首字母自动大写，但Android模拟器及真机上该配置完全无效。

原因分析 #

Android系统的第三方输入法（如Gboard）通常自带独立的大小写控制逻辑，会优先使用自身设置，从而覆盖Flutter框架提供的textCapitalization配置，导致该属性在Android端失效。

解决方案 #

使用inputFormatters自定义输入格式化器，强制实现首字母大写逻辑，该方式不受平台输入法影响，跨平台通用：

TextFormField(
  // 保留该配置作为输入法提示（可选）
  textCapitalization: TextCapitalization.words,
  inputFormatters: [
    TextInputFormatter.withFunction((oldValue, newValue) {
      final text = newValue.text;
      if (text.isEmpty) return newValue;
      
      // 处理每个单词首字母大写，其余部分保留原输入（需统一小写可修改为word.substring(1).toLowerCase()）
      final capitalizedText = text.split(' ').map((word) {
        if (word.length <= 1) return word.toUpperCase();
        return word[0].toUpperCase() + word.substring(1);
      }).join(' ');
      
      return TextEditingValue(
        text: capitalizedText,
        selection: newValue.selection,
        composing: newValue.composing,
      );
    }),
  ],
  // 其他配置项...
)

补充说明 #

• 若需限制输入内容（比如仅允许字母和空格），可在inputFormatters中添加FilteringTextInputFormatter.allow(RegExp(r'[a-zA-Z\s]'))
• 该方案会在用户输入过程中实时处理文本，确保每个单词首字母大写，完全不受输入法设置干扰

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