uni-app 中 pageScrollTo 在支付宝/百度小程序不支持，仅对页面根容器生效；需传 number 类型 scrollTop（单位 px），负值无效；首次调用建议延迟执行；scroll-view 需用其 scrollTo 方法。
uni-app 里 pageScrollTo 不起作用？先确认平台支持范围
微信小程序、App 和 H5 都支持 pageScrollTo，但支付宝小程序和百度小程序不支持该 API —— 调用后静默失败，无报错也无滚动。如果你在支付宝环境调试没反应，不是代码写错了，是根本不可用。
另外，pageScrollTo 只对页面根滚动容器生效（即整个 <page>），不适用于内部 <scroll-view>；后者得用它的 scroll-top 属性或 scrollTo 方法。
调用 pageScrollTo 的正确姿势：必须传 scrollTop，且单位是 px
常见错误是传了 0 却没加单位，或误传百分比、rem 等。它只接受数字类型（单位固定为像素），且目标值不能为负数。
-
uni.pageScrollTo({ scrollTop: 0 })✅ 正确，回到顶部 -
uni.pageScrollTo({ scrollTop: '0px' })❌ 报错或无效（类型必须是 number） -
uni.pageScrollTo({ scrollTop: -10 })❌ 会被截断为 0，但行为不稳定，别依赖 - 想带动画？必须显式加
duration，默认是 300ms，设为 0 会立刻跳转（无过渡）
点击按钮返回顶部时，为什么点一次没反应？检查是否在非首次渲染后调用
某些情况下（比如使用 v-if 切换显示返回按钮、或在 onLoad 里立即调用），pageScrollTo 可能因页面尚未完成布局而失效。稳妥做法是加一层微任务延迟：
uni.createSelectorQuery().selectViewport().boundingClientRect(res => {
uni.pageScrollTo({ scrollTop: 0, duration: 200 })
}).exec()
或者更轻量的：
setTimeout(() => {
uni.pageScrollTo({ scrollTop: 0 })
}, 30)
这不是 bug，而是部分平台对滚动时机的严格要求 —— 尤其在页面刚加载或 tab 切换后。
替代方案：当 pageScrollTo 不可用或需兼容 scroll-view 时
如果页面用了自定义滚动容器（比如长列表包裹在 <scroll-view scroll-y> 中），pageScrollTo 完全无效。此时要：
- 给
<scroll-view>绑定ref，例如<scroll-view ref="scrollView"> - 在方法中调用
this.$refs.scrollView.scrollTo({ scrollTop: 0, duration: 200 }) - H5 下还可直接操作 DOM：
document.documentElement.scrollTop = 0或document.body.scrollTop = 0，但注意 App 和小程序不支持
跨平台统一处理时，别硬塞一个 API 走到底；判断当前环境 + 滚动容器类型，再选路径，比强行兜底更可靠。
