防抖和节流需适配异步函数：debouncePromise 通过 pending 队列统一 resolve/reject 所有调用，适用于搜索建议；节流则用状态锁+时间戳控制执行节奏并复用前序 Promise，适用于滚动加载；均需保留取消能力、正确绑定 this/参数、不静默吞错。
防抖和节流本身不改变函数的同步/异步性质，但当原函数是异步的（比如返回 Promise 的搜索请求），直接套用基础版本会导致调用方拿不到结果、无法链式处理或出现竞态问题。关键在于让防抖/节流后的函数也返回 Promise，并统一管理执行时机与响应。
防抖 + Promise：debouncePromise 管理待决队列
普通防抖函数不返回值，而 debouncePromise 每次调用都立即返回一个 Promise，所有未执行的调用被暂存到 pending 队列中；等到延迟结束，只执行最后一次调用，但把结果 resolve 给所有排队的 Promise。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 内部维护一个 pending 数组，每次调用都 push 一个 res/rej 回调
- 定时器触发时，清空 pending 并批量调用
res(result)或rej(error) - 原函数的 this 和参数透传不变，错误会正常抛出并被捕获
- 适合搜索建议、表单校验等“只关心最终一次响应”的场景
节流 + Promise：需手动控制执行时机与结果分发
节流天然有“固定节奏”特性，不适合像防抖那样合并多次调用。更稳妥的做法是：每次节流窗口内允许执行一次异步函数，但确保前序 Promise 完成后再接受下一次调用，避免并发混乱。
- 用 时间戳 + 状态锁判断是否可执行，不可执行时直接返回上一个 Promise（或拒绝）
- 也可配合
Promise.race()实现超时降级，比如“300ms 内没响应就用缓存” - 不推荐用 setTimeout 版节流包装异步函数，容易因异步耗时长导致执行堆积或跳过
- 适合滚动加载、按钮防重复提交等“需要稳定节奏+结果反馈”的场景
通用注意事项
无论防抖还是节流，处理异步函数都要注意三点：
-
取消能力必须保留：比如用户切换页面前调用
debounced.cancel()，应主动 reject 所有 pending Promise -
this 和参数不能丢失：使用
func.apply(this, args)或箭头函数绑定，避免 Promise 中 this 指向 window - 错误不能静默吞掉：异步失败要 reject，否则 UI 会一直等待，建议加 try/catch 包裹 await 调用
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
