Flutter中如何实现TextField文本自动换行，同时禁用Enter键换行并保留其触发onSubmitted()方法的功能

我刚好处理过类似的需求，给你两个实用的方案，你可以根据自己的场景来选：

方案一：直接拦截Enter键事件（推荐） #

这个方案通过监听按键事件，直接接管Enter键的行为——触发提交逻辑，同时阻止默认的换行操作，完美保留自动换行的功能。

代码示例：

import 'package:flutter/services.dart';

// 记得先定义TextEditingController（如果需要的话）
final _textController = TextEditingController();

TextField(
  maxLines: null, // 开启自动换行
  controller: _textController,
  decoration: const InputDecoration(hintText: "请输入内容..."),
  onSubmitted: (submittedValue) {
    // 这里写你按下Enter后要执行的逻辑
    print("提交的内容：$submittedValue");
    // 比如发送消息、提交表单等操作
  },
  onKeyEvent: (KeyEvent event, FocusNode focusNode) {
    // 检测是否按下了Enter键
    if (event.logicalKey == LogicalKeyboardKey.enter && event is KeyDownEvent) {
      // 触发提交逻辑（可加非空判断）
      if (_textController.text.isNotEmpty) {
        onSubmitted!(_textController.text);
      }
      // 可选：让输入框失去焦点，模拟提交后的状态
      focusNode.unfocus();
      // 返回handled告诉Flutter我们已经处理了这个按键，阻止默认换行
      return KeyEventResult.handled;
    }
    // 其他按键正常处理
    return KeyEventResult.ignored;
  },
)

为什么推荐这个方案？ #

• 精准控制Enter键的行为，只拦截Enter键的换行，不影响文本超出宽度时的自动换行
• 可以灵活添加前置判断（比如输入不为空再提交）
• 不会干扰粘贴等其他输入操作的内容

方案二：使用输入格式化器过滤换行符 #

如果你需要统一处理所有输入中的换行符（包括用户粘贴进来的），可以用这个方案：

首先自定义一个TextInputFormatter：

class NoNewLineFormatter extends TextInputFormatter {
  @override
  TextEditingValue formatEditUpdate(
      TextEditingValue oldValue, TextEditingValue newValue) {
    // 移除所有换行符
    final cleanText = newValue.text.replaceAll('\n', '');
    return TextEditingValue(
      text: cleanText,
      selection: TextSelection.collapsed(offset: cleanText.length),
    );
  }
}

然后在TextField中使用：

TextField(
  maxLines: null,
  decoration: const InputDecoration(hintText: "请输入内容..."),
  onSubmitted: (value) {
    print("提交的内容：$value");
  },
  inputFormatters: [NoNewLineFormatter()],
)

注意点： #

这个方案会移除所有输入中的换行符，包括用户粘贴进来的换行文本。如果你的场景不需要过滤粘贴的换行，方案一更合适。

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