uni.pageScrollTo需在onReady或$nextTick后调用，确保DOM已挂载；目标scrollTop必须为数字，页面含scroll-view时应改用其ref的scrollTo方法；nvue页面不支持该API。
uni-app 里 uni.pageScrollTo 怎么用才有效
直接调用 uni.pageScrollTo 却没反应？大概率是页面还没渲染完，或者滚动容器不是页面根节点。uni-app 的页面滚动行为和 Web 端有差异：H5 和小程序的滚动主体不同，H5 是 <page></page> 或 <scroll-view></scroll-view>，而小程序里真正可滚动的是 <page></page> 根容器（App 端又另说）。
实操建议：
- 在
onReady或$nextTick后再调用，确保 DOM 已挂载（尤其 H5 端） - 目标位置必须是数字，不能传字符串
"0"，否则静默失败 - 如果页面用了
<scroll-view></scroll-view>，就不能用uni.pageScrollTo，得调它的scroll-top属性或scrollTo方法 - App 端需注意：nvue 页面不支持
uni.pageScrollTo，只能用this.$refs.scrollView.scrollTo(0, 0)
示例（通用 H5/小程序）：
uni.pageScrollTo({
scrollTop: 0,
duration: 300
});
为什么 scroll-view 里 uni.pageScrollTo 失效
因为 uni.pageScrollTo 滚的是整个页面，而 <scroll-view></scroll-view> 是局部滚动容器，它自己维护滚动状态，和页面无关。你调页面滚动，它根本收不到事件。
实操建议：
- 给
<scroll-view></scroll-view>加ref，比如<scroll-view ref="myScrollView"></scroll-view> - H5 端可用
this.$refs.myScrollView.$el.scrollTop = 0 - 小程序端推荐用
this.$refs.myScrollView.scrollTo({scrollTop: 0})（需 uni-app 3.0+） - 避免同时存在多个
<scroll-view></scroll-view>且都设了scroll-y，容易互相干扰
错误写法（白忙活）：
<scroll-view scroll-y>...</scroll-view>
uni.pageScrollTo({ scrollTop: 0 }); // ❌ 不起作用
不同平台下 scrollTop 行为差异
小程序真机上，scrollTop 为 0 时可能仍显示一点偏移，这是微信底层对“顶部”的定义问题；App 端 nvue 中，scrollTop 是像素值，但初始值未必是 0；H5 则受 CSS body margin/padding 影响，实际滚动起点可能偏移。
实操建议：
- 统一加个容错偏移：
scrollTop: -1或scrollTop: 1试试手感（尤其小程序） - H5 端检查
body { margin: 0; padding: 0; }，否则scrollTop: 0可能滚不到视觉顶部 - App 端若用 vue 页面，
uni.pageScrollTo在 tabbar 页面中可能被拦截，优先改用uni.switchTab+ 页面内手动置顶
回到顶部按钮点击无响应的常见埋点
不是代码写错了，而是交互链路断在了看不见的地方：比如按钮绑了 @click，但父元素有 catchtouchmove 阻止了冒泡；或者页面处于 scroll-y 的 <scroll-view></scroll-view> 内，但按钮没加 catchtap 导致事件被吞。
排查要点：
- 按钮是否被
<cover-view></cover-view>包裹？小程序中cover-view上的事件必须用bind:tap，不能用@click - 是否在
onPullDownRefresh期间触发？部分平台会禁用滚动操作 - 是否在
onReachBottom加载中重复点击？建议加节流或 loading 状态锁 - 安卓 App 端有时因 WebView 渲染延迟，
pageScrollTo调用后立刻读scrollTop仍是旧值，别拿它做判断依据
事情说清了就结束
