跨平台开发 / 系统课时

为搜索输入增加防抖

为搜索输入增加防抖

搜索框会随着用户输入不断触发变化事件,如果每次按键都发送网络请求,会造成大量无效请求并增加服务器压力。本篇实现 Flutter 搜索输入防抖,让接口只在用户停止输入一段时间后执行,提高搜索体验和请求效率。

学习目标

  • 理解搜索场景中的防抖机制
  • 使用 Timer 实现输入事件延迟执行
  • 在 Flutter 中安全管理搜索请求触发逻辑

搜索请求为什么需要防抖

用户输入关键词时,输入框变化通常非常频繁。例如输入 flutter 时,会连续产生多个状态变化:

f → fl → flu → flut → flutt → flutter

如果每次变化都调用接口,前几个请求大概率没有意义,而且可能造成返回顺序混乱:旧关键词请求晚返回,覆盖了最新搜索结果。

防抖的思路是等待用户停止输入后再执行请求。如果等待时间内再次输入,则取消之前的等待任务。

使用 Timer 实现防抖

Flutter 中可以使用 dart:async 提供的 Timer 管理延迟任务。

下面示例展示一个搜索控制器,输入变化后等待 <TIME> 毫秒再执行搜索。

dart
import 'dart:async';

class SearchController {
  Timer? _debounceTimer;

  void onSearchChanged(String keyword) {
    _debounceTimer?.cancel();

    _debounceTimer = Timer(
      const Duration(milliseconds: 500),
      () {
        search(keyword);
      },
    );
  }

  Future<void> search(String keyword) async {
    if (keyword.isEmpty) {
      return;
    }

    print('request keyword: $keyword');
  }

  void dispose() {
    _debounceTimer?.cancel();
  }
}

预期输出

text
用户输入:
f
fl
flu
flutter

500ms 内没有继续输入

request keyword: flutter

在输入框中接入防抖逻辑

文本输入组件只负责监听变化,将搜索调度交给控制器处理,可以避免页面代码承担请求细节。

dart
TextField(
  onChanged: controller.onSearchChanged,
  decoration: const InputDecoration(
    hintText: '搜索内容',
  ),
)

预期结果

text
输入框变化
→ onChanged 接收新文本
→ 取消旧 Timer
→ 创建新的 Timer
→ 用户停止输入后发送一次请求

防抖实现中的注意事项

防抖只能减少请求次数,不能替代请求状态管理。真实网络搜索通常还需要结合请求取消或请求序号校验,避免旧请求覆盖新结果。

还需要注意:

  • 页面销毁时取消 Timer,避免触发已释放对象
  • 防抖时间需要根据业务调整,通常几百毫秒即可
  • 空关键词可以直接清空结果,不必发送接口请求

防抖适合处理连续输入事件,例如搜索、筛选、自动补全等场景。当事件频率高但最终结果只需要最后一次时,防抖可以有效降低无效计算和网络开销。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为搜索输入增加防抖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通