toggle事件本身只触发一次，所谓“重复触发”多因混用onclick/ontoggle、未阻止原生行为、重复添加监听器或状态与DOM不同步所致；调试应先确认是否真重复，再针对性修复。
toggle 事件本身不会重复触发
所谓“触发两次”，几乎全是开发中混用行为导致的假象：onclick 和 ontoggle 同时绑定在同一个 <summary></summary> 上，或 React/Vue 中未阻止原生切换逻辑。原生 <details></details> 的 toggle 事件只响应用户点击 <summary></summary> 的动作，且严格派发一次。调试时可用 console.count('toggle fired') 确认是否真重复——多数情况是日志被多次调用，而非事件本身多发。
React 中必须禁用原生行为并接管状态
若用 onClick={() => setIsOpen(!isOpen)} 但没加 e.preventDefault()，浏览器会先翻转 open 属性，再执行你的 setState，造成 DOM 与 React state 脱节，后续点击就反复横跳。正确做法是：
- 给
<summary></summary>绑定onClick，开头立即调用e.preventDefault() - 用
useState管理open状态，并通过open={isOpen}显式透传给<details></details> - 完全不监听
toggle事件来更新 state——你已用 click 控制了全部开闭入口 - 多个
<details></details>需手风琴效果时，state 应为字符串 ID 或索引，而非布尔值
addEventListener 注册时必须清理旧监听器
在组件挂载时用 useEffect 添加 toggle 监听器，却没返回清理函数，会导致每次重渲染都新增一个监听器，看着像“重复触发”。关键点：
- 注册时务必写
return () => el.removeEventListener('toggle', handler) - 绝不在 render 函数里直接写
el.addEventListener('toggle', )，那会每次渲染都加一遍 -
toggle事件不冒泡，父元素监听不到子<details></details>变化，别试事件委托
防抖不是 toggle 事件的解药，而是状态竞争的补丁
快速连点引发的状态错乱（比如按钮还没收起就又点开），本质是 UI 更新和状态变更不同步。此时防抖只是兜底手段，重点在于：
立即学习“前端免费学习笔记（深入）”；
- 只对 setState 或 DOM 操作防抖，而不是对
toggle事件本身防抖 - 防抖时间设为 150–200ms 即可，过长影响手感
- 务必在页面卸载前
clearTimeout(debounceTimer)，否则可能操作已销毁的 DOM - 如果逻辑含异步（如 fetch 查重），需取消上一轮请求，避免响应覆盖
真正容易被忽略的是：toggle 事件只告诉你“用户点了”，它不负责同步状态；而 DOM 的 open 属性和框架的 state 是两套系统，不显式对齐就会错乱。别指望事件自动帮你管好 UI。
