实现“首击响应+尾击保底”的关键是用闭包统一管理previous和timeout状态，并通过leading与trailing开关协同控制：leading为true时，首次及间隔达标即刻执行；trailing为true时，未达间隔则启用唯一兜底定时器，执行后清空timeout并更新previous；二者同为true最稳妥，同为false应禁止。

要实现“首击响应 + 尾击保底”，关键不是选时间戳版或定时器版，而是用一个闭包统一管理 previous（上一次执行时间）和 timeout（兜底定时器）两个状态，并通过 leading 与 trailing 开关控制行为分支。

首击怎么立刻执行？靠时间戳差值判断

每次触发时取 Date.now()，和 previous 做差：

• 若 leading === true 且 now - previous >= wait，直接执行函数，立即更新 previous = now
• 这个判断天然覆盖首次（因 previous 初始为 0，差值必 ≥ wait），无需额外标记“是否首次”
• 后续只要间隔够，仍可立即执行，保持节奏稳定

尾击怎么确保不丢？靠唯一兜底定时器

当不满足立即执行条件时，启动一次性的兜底保障：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• 仅在 trailing === true 且当前没有待执行的定时器（!timeout）时，才调用 setTimeout
• 定时器回调里执行函数后，必须清空 timeout = null，并更新 previous = Date.now()
• 这样能避免连续触发导致多个定时器堆积，也防止兜底执行后时间戳滞后引发误判

leading 和 trailing 的组合逻辑要闭环

二者不是独立运行，而是在同一作用域内协同决策：

• leading: false → 跳过首次立即执行，所有触发都走兜底路径（相当于纯定时器节流）
• trailing: false → 不设兜底定时器，退化为纯时间戳节流（末次可能丢失）
• 两者都为 true（默认）→ 首次立刻、末次补发，滚动加载、拖拽反馈等场景最稳妥
• 两者都为 false → 函数不再执行，应被禁止或抛错提示

实际使用注意细节

真正落地时，几个点容易出错：

• 函数执行时需正确绑定 this 并透传参数，不能只写 func()
• 定时器必须在执行后清除，否则内存泄漏 + 多次重复执行
• 滚动/输入等事件对象是复用的，别把整个 event 传进节流函数，只取需要的字段（如 scrollTop）
• 如需手动取消节流（比如组件卸载），暴露 cancel 方法清理 timeout 和重置 previous