iOS端Flutter SpellCheckConfiguration配置失效问题求助

问题场景 #

配置了 SpellCheckConfiguration 的 TextFormField 在 iOS 端无法显示错误单词的红色波浪下划线，尝试过 CupertinoTextField 和普通 TextField 组件均无效，代码如下：

TextFormField(
        spellCheckConfiguration: SpellCheckConfiguration(
          misspelledSelectionColor: Colors.red,
          spellCheckService: DefaultSpellCheckService(),
        ),
        autovalidateMode: AutovalidateMode.onUserInteraction,
        controller: descriptionController,
        textInputAction: TextInputAction.done,
        keyboardType: TextInputType.multiline,
        maxLines: 4,
        maxLength: 250,
        maxLengthEnforcement: MaxLengthEnforcement.enforced,
        onSaved: (newValue) =>
            campaignPostViewController.setDescription(newValue!),
        style: TextStyle(color: ColorConstants.white, fontSize: 14.sp),
        focusNode: campaignPostViewController.descriptionFocusNode,
        decoration: const InputDecoration(
          hintText: 'your hint',
          hintStyle: TextStyle(
            color: Colors.white,
            fontSize: 16,
            fontWeight: FontWeight.w500,
          ),
          enabledBorder: UnderlineInputBorder(
            borderSide: BorderSide(color: Colors.transparent),
          ),
          focusedBorder: UnderlineInputBorder(
            borderSide: BorderSide(color: Colors.transparent),
          ),
          contentPadding: EdgeInsets.all(0),
        ),
      )

排查与解决步骤 #

• 检查 iOS 系统拼写设置：打开设备「设置」-「通用」-「键盘」，确保「拼写检查」开关处于开启状态，系统全局关闭的话，Flutter 无法调用原生拼写服务。
• 排查颜色冲突或遮挡：你当前设置文本为白色、输入框边框透明，可能红色波浪线和背景对比度太低导致看不见。可以临时把文本改成深色、背景设为浅色测试，确认是否是这个问题。
• 显式开启 autocorrect：不管用哪种输入组件，都显式设置 autocorrect: true（默认值为 true，但显式配置能避免意外），iOS 端拼写检查依赖自动校正功能。
• 移除手动指定的 DefaultSpellCheckService：DefaultSpellCheckService 是 Flutter 调用 iOS 原生拼写服务的默认实现，手动指定可能引发冲突，直接删掉这行配置，让系统自动处理即可。
• 升级 Flutter 版本：部分旧版 Flutter 在 iOS 拼写检查上存在兼容性 bug，建议升级到最新稳定版（如 3.10 及以上）。
• 测试纯英文输入：拼写检查默认针对英文，确保输入的是英文单词，且系统键盘切换到英文输入法、对应语言的拼写检查已开启。

调整后的测试代码示例 #

TextFormField(
  spellCheckConfiguration: const SpellCheckConfiguration(
    misspelledSelectionColor: Colors.red,
  ),
  autocorrect: true,
  autovalidateMode: AutovalidateMode.onUserInteraction,
  controller: descriptionController,
  textInputAction: TextInputAction.done,
  keyboardType: TextInputType.multiline,
  maxLines: 4,
  maxLength: 250,
  maxLengthEnforcement: MaxLengthEnforcement.enforced,
  onSaved: (newValue) =>
      campaignPostViewController.setDescription(newValue!),
  style: const TextStyle(color: Colors.black, fontSize: 14), // 临时修改颜色测试
  focusNode: campaignPostViewController.descriptionFocusNode,
  decoration: const InputDecoration(
    hintText: 'your hint',
    hintStyle: TextStyle(
      color: Colors.grey,
      fontSize: 16,
      fontWeight: FontWeight.w500,
    ),
    enabledBorder: UnderlineInputBorder(
      borderSide: BorderSide(color: Colors.grey),
    ),
    focusedBorder: UnderlineInputBorder(
      borderSide: BorderSide(color: Colors.blue),
    ),
    contentPadding: EdgeInsets.all(8),
  ),
)

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