下拉刷新常见问题包括重复请求、loading滞留、刷新动画卡住及scrollY误判。需统一用refresh()控制流程、设isRefreshing守卫、显式调用finishPullDown，并在touchend后校验滚动状态。

下拉刷新和数据更新本身不冲突，但实现时若没处理好状态同步，会直接导致重复请求、界面错乱或 loading 状态滞留。

下拉刷新触发后，fetch 请求发了两次

常见于监听 pullingDown 事件后未禁用按钮或未加防抖，又在 refresh 回调里手动调用了同一数据函数。

• 检查是否同时绑定了 touchstart + pullingDown 两套逻辑，保留一套即可
• pullingDown 触发时立即设 isRefreshing = true，并在请求开始前加 if (isRefreshing) return 守卫
• 避免在 onPullingDown 里直接调 loadData()，应统一走 refresh() 方法，由它控制加载流程

setState 更新数据后，下拉刷新组件没重置

React/Vue 中常见：数据更新了，但下拉控件（如 van-pull-refresh 或自定义 scrollTop 监听）仍卡在“正在刷新”动画，无法再次下拉。

Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

• 必须显式调用 finishPullDown() 或 done()（不同库 API 不同），不能只靠 setState
• 如果用了 useEffect 响应数据变化来调 finishPullDown，注意依赖数组别漏掉分页参数或时间戳，否则可能漏触发
• 某些 UI 库要求在 DOM 重绘后调用 finishPullDown，可包一层 setTimeout(() => finishPullDown(), 0)

下拉刷新时用户快速上滑，scrollY 判断失效

纯手写下拉刷新依赖 scrollY 和 clientHeight 计算位移，但滚动惯性会让 scrollY 在手指离开后继续变化，导致“松手即刷新”误判。

• 只在 touchend 且 scrollY （阈值）时触发刷新，不依赖持续的 <code>scroll 事件
• 记录 touchstart 时的 scrollTop，后续位移基于差值计算，而非绝对 scrollY
• 避免在 scroll 事件里频繁 setState，改用 requestIdleCallback 或节流

真正难的不是“怎么触发刷新”，而是“怎么让刷新状态和业务数据生命周期对齐”——比如分页数据更新后要重置当前页码，loading 状态要和网络请求原子绑定，而这些细节恰恰不会出现在任何“下拉刷新教程”的示例代码里。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！