防抖函数在主题皮肤切换中用于避免频繁操作导致的重复渲染、多余请求和样式闪烁，确保切换逻辑仅在用户停顿后执行一次。
防抖函数在主题皮肤切换中主要用于避免用户频繁点击或快速触发切换操作（比如连点深色/浅色按钮、滚动时自动匹配系统主题等）导致的重复渲染、多余请求或样式闪烁问题。核心是让切换逻辑只在用户“真正停顿”后执行一次。
防抖解决什么问题
主题切换常涉及 CSS 变量更新、localStorage 写入、甚至调用 API 同步偏好。若用户连续点击 3 次「切换主题」按钮，未加防抖就会执行 3 次完整流程：写入本地存储 → 修改 document.documentElement.classList → 触发重绘 → 可能还发一次请求。这不仅浪费资源，还可能因异步执行顺序错乱导致最终状态与预期不符（比如最后写入的是浅色，但 class 却残留深色）。
基础防抖函数实现
一个轻量、可复用的防抖函数：
function debounce(fn, delay) {
let timer;
return function (...args) {
clearTimeout(timer);
timer = setTimeout(() => fn.apply(this, args), delay);
};
}
注意：必须确保每次调用都绑定正确的 this 和参数，所以用 fn.apply(this, args) 而非直接 fn(...args)（避免箭头函数丢失上下文）。
立即学习“Java免费学习笔记（深入）”；
在主题切换中实际应用
以点击按钮切换深色/浅色为例：
- 把主题切换逻辑（如 updateTheme(theme)）包裹进防抖函数
- 延迟设为 150–300ms 足够过滤误点，又不会感知卡顿
- 确保防抖后的函数是「同一个引用」，否则每次重新绑定会清掉上一个定时器失效
const debouncedToggle = debounce(() => {
const current = document.documentElement.getAttribute('data-theme');
const next = current === 'dark' ? 'light' : 'dark';
updateTheme(next); // 包含 localStorage.setItem + class 切换等
}, 200);
toggleBtn.addEventListener('click', debouncedToggle);
⚠️ 关键细节：debouncedToggle 必须定义在事件监听外，否则每次监听都新建一个防抖实例，起不到防抖作用。
配合系统主题自动同步时也建议防抖
监听 prefers-color-scheme 变化时，浏览器可能在窗口缩放、分屏、系统设置刚改时高频触发 change 事件：
- 用 matchMedia('(prefers-color-scheme: dark)') 监听
- 回调里调用防抖后的 syncWithSystem()，而非直接执行
- 尤其在 Electron 或桌面 PWA 中，系统级主题变更可能触发多次，防抖能稳住最终状态
不复杂但容易忽略
