uni.pageScrollTo需在页面渲染完成后再调用，推荐onReady后加setTimeout或nextTick；注意平台兼容性，微信2.7.0+支持duration，支付宝不支持，App端需nvue；自定义容器须用scroll-view的ref.scrollTo。
uni-app 中 uni.pageScrollTo 的正确调用时机
页面还没渲染完成就调用 uni.pageScrollTo，滚动会失效或跳转不准确。这不是 API 有问题，而是执行太早——比如在 onLoad 或 onShow 里直接调用，此时 DOM 可能尚未生成或高度未稳定。
- 必须等页面内容渲染完毕再触发，推荐用
setTimeout延迟 100ms（实测多数场景够用），或监听onReady后加微任务 - 如果页面含异步数据（如请求后动态插入列表），要等数据渲染完成，可在
nextTick或setData回调后调用 - 在 H5 端可用
document.documentElement.scrollTop = 0作为备选，但小程序端无效，务必统一走uni.pageScrollTo
为什么 uni.pageScrollTo 在某些小程序平台没反应
主要是参数校验或平台兼容性差异：微信小程序基础库 2.7.0+ 才完整支持 duration，旧版本会忽略该字段并立即跳转；支付宝小程序则不支持 duration，设了也无效；App 端（v3）需确保使用的是 nvue 页面，否则 pageScrollTo 不生效。
- 始终传入
{scrollTop: 0}，duration设为 300 或省略（默认 300ms）即可，不要设 0 —— 某些平台会当无效值处理 - 真机调试时发现无效，先检查
uni.getSystemInfoSync().platform，确认当前环境是否支持该 API（如字节跳动小程序部分版本不支持） - 避免在
onPullDownRefresh结束后立刻调用，需先uni.stopPullDownRefresh()，再延迟调用，否则可能被下拉动画阻塞
封装一个可复用的「回到顶部」按钮组件
直接写内联逻辑容易重复、难维护，建议抽成独立组件，关键点是监听滚动位置 + 条件显示 + 安全触发。
- 用
uni.createSelectorQuery()获取页面容器节点（如.page-container）的scrollTop，比依赖onReachBottom更准 - 按钮显隐逻辑别只靠
scrollTop > 100，应结合uni.getSystemInfoSync().windowHeight判断是否已滚出首屏，避免误触 - 点击后立即将按钮置灰（
disabled状态），防止连续点击导致多次调用，回调中再恢复 —— 尤其在慢网络下很有必要 - 示例触发代码：
uni.pageScrollTo({ scrollTop: 0, duration: 300 });
自定义滚动容器（非整页）时怎么处理
如果「回到顶部」目标不是整个页面，而是某个 scroll-view 区域，就不能用 uni.pageScrollTo，必须改用组件自身的 scroll-top 绑定 + ref 控制。
- 给
<scroll-view ref="myScrollView"></scroll-view>设置 ref，在方法中通过this.$refs.myScrollView.scrollTo({scrollTop: 0})调用（仅 Vue 版本支持） - nvue 页面中，
scroll-view的scrollTo方法参数为{y: 0, animated: true}，注意 y 是像素值，不是 scrollTop - 若容器高度动态变化（如折叠面板展开），需在变化后手动重置
scroll-top值，否则下次滚动起点错位
uni.pageScrollTo 没有 success 回调，所以无法精准判断何时真正停稳 —— 如果后续逻辑（比如聚焦输入框）依赖滚动完成，得自己加定时轮询或监听 onPageScroll 的 scrollTop === 0 状态。 
