欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net

前言

在 OpenHarmony 应用交互中，我们经常会遇到高频触发的事件，例如：触控板滑动、搜索框输入、或者快速点击按钮。如果每次触发都执行耗时的逻辑（如网络请求或复杂计算），会造成应用卡顿甚至资源浪费。

rate_limiter 是一个专为 Dart 打造的轻量级频率控制库。它通过简单的装饰器模式，为你的方法提供“节流（Throttle）”和“防抖（Debounce）”能力。

一、核心概念对比

二、核心 API 实战

2.1 简单防抖 (Debounce)

当用户连续操作时，仅在最后一次操作后的规定时间（如 500ms）才执行任务。

import 'package:rate_limiter/rate_limiter.dart';

void initDebouncer() {
  // 1. 💡 定义业务逻辑并应用防抖逻辑
  final debouncedAction = (() {
    print('✅ 已在 500ms 内没有新的点击，现在执行任务');
  }).debounce(const Duration(milliseconds: 500));

  // 2. 💡 模拟高频调用
  debouncedAction();
  debouncedAction();
  debouncedAction(); // 最终只会执行这一次
}

2.2 简单节流 (Throttle)

防止用户在短时间内疯狂并发请求，在一个周期内只响应第一次任务。

final submitAction = (() {
  print('✅ 提交请求已受理 (2 秒内禁止重复提交)');
}).throttle(const Duration(seconds: 2));

// 即使用户一秒内点了 10 次，两秒内也只会触发 1 次
submitAction();

2.3 带参数的高级用法

rate_limiter 完美支持传递复杂参数。对于带参数的方法，返回的是一个 Tick 对象。

final updateScore = ((int score, String userId) {
  print('✅ 更新用户 $userId 的分数为: $score');
}).debounce(const Duration(seconds: 1));

// 💡 注意：调用带参数的防抖函数时，参数需要放在 List 中
updateScore([100, "user_001"]);

三、OpenHarmony 平台适配

3.1 性能优化

由于鸿蒙系统的 ArkUI 渲染引擎对帧率要求极高，在高频手势监听（如 onPanUpdate）中使用 rate_limiter 可以有效减轻 Dart 虚拟机的计算压力，保持 UI 丝滑。

3.2 内存管理

💡 技巧：在鸿蒙组件销毁时，建议取消正在挂起的延迟任务。

final debouncer = myMethod.debounce(const Duration(seconds: 1));
// ...
debouncer.cancel(); // 💡 销毁时清理，防止泄露

四、完整实战示例：鸿蒙搜索防抖器

本示例展示了如何在鸿蒙应用中实现一个实时搜索框，并利用防抖技术优化性能。

import 'package:flutter/material.dart';
import 'package:rate_limiter/rate_limiter.dart';

class OhosSearchDemo extends StatefulWidget {
  @override
  _OhosSearchDemoState createState() => _OhosSearchDemoState();
}

class _OhosSearchDemoState extends State<OhosSearchDemo> {
  String _displayText = "等待输入...";
  late DebounceTick _debouncedAction;

  @override
  void initState() {
    super.initState();
    // 1. 初始化防抖函数：延迟 800ms 执行
    _debouncedAction = ((String val) {
      setState(() {
        _displayText = "搜索关键词: $val (已发送请求)";
      });
    }).debounce(const Duration(milliseconds: 800));
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('鸿蒙性能优化 - 频率控制')),
      body: Padding(
        padding: const EdgeInsets.all(20.0),
        child: Column(
          children: [
            TextField(
              decoration: InputDecoration(
                labelText: '试试快速输入内容',
                border: OutlineInputBorder(),
              ),
              onChanged: (text) {
                setState(() => _displayText = "正在输入...");
                // 2. 调用防抖函数
                _debouncedAction([text]);
              },
            ),
            SizedBox(height: 50),
            Text(_displayText, style: TextStyle(fontSize: 18, color: Colors.blue)),
          ],
        ),
      ),
    );
  }
}

五、总结

rate_limiter 虽然只是一个小工具，但在 OpenHarmony 的高性能应用开发中扮演着“减速阀”的关键角色。通过合理使用节流和防抖，你可以极大地提升鸿蒙应用的交互体验，同时降低不必要的后端负载。