防抖函数底层原理是每次触发重置倒计时，核心靠闭包持久保存timer变量，并通过clearTimeout清除旧定时器、setTimeout设置新定时器来确保仅最后一次执行；闭包保障各实例timer互不干扰，immediate模式支持首次立即执行，后续仍按防抖逻辑重置。

防抖函数的底层原理，就是靠“每次触发都重置倒计时”来确保只响应最后一次操作。它不靠魔法，核心就两点：闭包保存定时器 ID，配合 clearTimeout + setTimeout 实现精准控制。

为什么必须用闭包存 timer

timer 变量必须在多次调用之间保持“记忆”，不能每次都是新的。闭包让返回的函数能持续访问外层作用域里声明的 timer，这个变量既私有又持久：

• 全局放 timer → 多个防抖实例互相覆盖，冲突
• 写在内层函数里 → 每次调用都新建，clearTimeout 失效，旧定时器照常执行
• 闭包提供专属空间 → 每个 debounce(fn, delay) 返回的函数，都独享自己的 timer，互不干扰

定时器怎么做到“只执行最后一次”

关键不是等时间到，而是“只要还在动，就不停清掉上一个、再设一个新的”：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 用户输入第 1 个字符 → 启动 300ms 定时器
• 0.1s 后输入第 2 个 → clearTimeout 干掉前一个，再启一个新 300ms 定时器
• 再过 0.15s 输入第 3 个 → 再清、再设
• 停顿满 300ms 后没新输入 → 定时器真正触发，执行回调

immediate 模式怎么切换逻辑

立即执行模式不是“每次都立刻跑”，而是“第一次触发马上执行，之后仍按防抖逻辑重置”：

• immediate 为 true 且 timer 为空 → 当前这次立刻执行 fn
• 后续任意一次触发 → 先清旧 timer（如果有），再设新定时器（用于重置）
• 定时器到期后，不执行 fn（因为已执行过），只清空 timer，为下次准备

实际使用绕不开的细节

光有逻辑不够，this、参数、手动清理这些一漏就出问题：

• this 绑定：用 fn.apply(this, args) 或 fn.call(this, ...args)，避免上下文丢失
• 参数传递：事件回调里的 event 对象要完整传入，不能只传空数组
• cancel 方法：组件卸载或表单重置时调用，防止定时器在销毁后还试图执行
• timer = null：定时器回调末尾主动清空，方便下次判断是否首次触发，也减少内存残留