uni.pagescrollto在导航栏点击中直接调用无效，因dom未就绪；需在onready或settimeout延迟50ms后调用，自定义导航栏并绑定view点击事件，支付宝/百度小程序不支持该api需降级处理，含scroll-view时须通过ref调用其scrollto方法。
uni.pageScrollTo 在导航栏点击事件中直接调用无效？
绝大多数情况下，点导航栏标题没反应，不是逻辑写错了，而是 uni.pageScrollTo 被执行得太早——页面 DOM 还没完成渲染，滚动容器高度未稳定，API 调用静默失败。
尤其在微信小程序中，onLoad 或 onShow 里立即调用，大概率白忙活；H5 端还可能因 CSS margin/padding 导致 scrollTop: 0 实际没到视觉顶部。
- 必须等页面真正就绪：优先在
onReady钩子中触发，或加setTimeout延迟 30–100ms（实测 50ms 覆盖多数场景） - 避免在
onPullDownRefresh结束后立刻调用，要先uni.stopPullDownRefresh()，再延迟执行 - 别在
onNavigationBarButtonTap里直接调，这个回调触发时机比onReady更早，容易踩坑
导航栏标题绑定 click 事件的正确写法
uni-app 的导航栏标题默认不可交互，得先自定义导航栏，再用 view 模拟标题区域，并绑定点击逻辑。
关键点：不能依赖原生标题，必须用页面内 DOM 元素承载点击行为。
- 在
pages.json中关闭原生导航栏："navigationStyle": "custom" - 页面内用
<view class="nav-title">我的页面</view>替代标题，并绑定@click="handleTop" -
handleTop方法里不要直接写uni.pageScrollTo({ scrollTop: 0 })，要包一层延迟：
handleTop() {
setTimeout(() => {
uni.pageScrollTo({ scrollTop: 0, duration: 300 })
}, 50)
}
如果页面含异步数据（比如列表请求后渲染），建议改用 this.$nextTick 或在请求回调里触发，确保 DOM 已更新。
支付宝/百度小程序点标题没反应？不是 bug 是限制
uni.pageScrollTo 在支付宝小程序和百度小程序中**完全不支持**，调用后既无报错也无滚动，属于平台级缺失，不是代码问题。
此时必须降级处理：
- 判断平台：
const { platform } = uni.getSystemInfoSync() - 支付宝/百度环境，改用
document.documentElement.scrollTop = 0（仅 H5 有效）→ 但 H5 不是目标平台，所以实际只能禁用该功能或隐藏按钮 - 更稳妥的做法：用
uni.createSelectorQuery().selectViewport()获取视口并尝试滚动，虽仍不生效，但可统一兜底逻辑 - 真机调试前务必加平台判断，避免用户误点无反馈
页面含 时标题点击只滚局部？
如果整个页面内容被包在 <scroll-view scroll-y></scroll-view> 里，那么 uni.pageScrollTo 对它完全无效——它只作用于页面根容器（<page></page>），而 <scroll-view></scroll-view> 是独立滚动上下文。
此时必须切换控制对象：
- 给
<scroll-view ref="listView"></scroll-view>加 ref - 点击方法中调用：
this.$refs.listView.scrollTo({ scrollTop: 0, duration: 300 }) - H5 端兼容写法：
this.$refs.listView.$el.scrollTop = 0（需确保 ref 绑定成功且元素已挂载） - 注意：多个
scroll-view同时存在时，ref 名称必须唯一，否则取不到正确实例
最易忽略的一点：自定义导航栏 + scroll-view 组合下，你点的是「页面标题」，但真正要滚动的是「内部容器」，两者滚动主体分离，不显式指定 ref 就永远滚不对地方。
