下拉刷新区域必须用 position: fixed 定位，避免插入内容流导致滚动错位；需通过 document.scrollingElement 获取 scrollTop 判断是否在顶部，并在刷新完成后手动重置 scrollTop 和 transform。
下拉刷新区域必须用 position: fixed，不能插在内容流里
把刷新提示（比如“下拉刷新…”文字或 loading 图标）直接塞进列表顶部、用 margin-top 或 padding-top 推开，是常见错误。它会撑高文档高度，导致滚动错位、白屏闪动，甚至触发 iOS Safari 的渲染异常。
正确做法是让刷新容器脱离文档流：
- 用
position: fixed; top: 0; left: 0; width: 100%; height: 60px;定位 - 内容区整体加
margin-top: 60px（初始状态），下拉时动态改这个值，或更推荐用transform: translateY()平滑移动 - 务必设置
pointer-events: none在整个刷新容器上（除加载图标外），否则会拦截后续点击和滚动事件 - 如果用
transform，建议加will-change: transform提升 iOS Safari 渲染性能
scrollTop === 0 判断必须用 document.scrollingElement
直接读 document.body.scrollTop 在 iOS Safari 下几乎总是 0，而 document.documentElement.scrollTop 又在某些 Android WebView 中不准。硬写死会导致判断失效，页面中部也能拉出刷新区。
安全写法是统一取滚动根节点：
立即学习“前端免费学习笔记（深入）”；
- 用
const scrollEl = document.scrollingElement || document.documentElement - 所有判断都基于
scrollEl.scrollTop === 0 - 监听事件也得绑在同一个滚动容器上（比如那个
div.scroller），而不是document或window
松手后必须手动重置 scrollTop，哪怕它本来就是 0
很多实现只管拉、不管收——松手触发刷新后，没重置容器的滚动位置，下次再下拉时 scrollTop 可能已非 0，导致无法再次进入“可下拉”状态。
刷新完成回调里必须显式归零：
- 调用
scrollEl.scrollTop = 0（注意不是scrollTo(0, 0)，后者可能被浏览器忽略） - 如果用了
transform移动内容区，也要同步清空transform: translateY(0) - 动画回弹完成后才执行这步，否则用户看到“刷完又自动滚回顶部”的突兀效果
嵌套滚动容器要防事件穿透，overscroll-behavior: contain 是辅助项
当列表本身在一个 overflow-y: auto 的父容器里（比如 tab 页面中带滚动的子页），手指在子容器内下拉，容易误触发父容器的原生 overscroll 或干扰手势识别。
加 CSS 能缓解但不解决根本问题：
- 在子滚动容器上设
overscroll-behavior: contain，禁用其弹性回弹 - 但它不兼容 IE 和旧版 Android WebView，iOS Safari 13+ 才稳定支持
- 真正关键的是：touch 事件必须绑定在该子容器上，并在
touchmove中只对它的scrollTop做判断 - 别让父容器和子容器同时监听同一类 touch 事件，否则状态混乱
transform、未清除的 event listener、或缓存的 scrollTop 值，都会让下拉逻辑突然失灵。 
