pageScrollTo不生效主因是页面未启用原生滚动：需在pages.json中设"disableScroll": false，且页面根节点须为原生而非或；H5可滚body，小程序则严格依赖原生容器。
uni-app 中 pageScrollTo 不生效的常见原因
直接调用 uni.pageScrollTo 却没反应？大概率是因为目标页面不是「滚动容器」——pageScrollTo 只对 <page></page> 根节点生效，而 uni-app 的页面默认根节点是 <view></view> 或 <scroll-view></scroll-view>，并非原生 page 级滚动。H5 和小程序表现还不一致：H5 下它会尝试滚动 document.body，但小程序（尤其是微信）严格依赖页面级滚动容器。
解决前提是确认当前页面启用了「原生页面滚动」：在 pages.json 中对应页面配置 "disableScroll": false（默认值），且不要包裹在 <scroll-view></scroll-view> 内；否则滚动权被子组件接管，pageScrollTo 就失效。
如何正确触发平滑滚动到指定位置
必须确保滚动目标在页面根节点内、且有足够高度可滚。推荐做法是：给目标元素加 id（如 <view id="section2"></view>），再用 uni.createSelectorQuery() 获取其距离页面顶部的偏移，传给 uni.pageScrollTo。
-
duration必须是数字（单位 ms），设为 0 会变成瞬移，设为 300–600 是较自然的平滑区间 - H5 端支持
selector参数（如{selector: '#section2'}），但微信小程序不支持，必须手动计算scrollTop - 首次获取
boundingClientRect可能返回top: 0（因渲染未完成），建议加nextTick或延时 30ms 再查
uni.createSelectorQuery()
.select('#section2')
.boundingClientRect()
.exec(res => {
if (res[0]) {
uni.pageScrollTo({
scrollTop: res[0].top,
duration: 400
})
}
})
替代方案：用 <scroll-view></scroll-view> 自控滚动更可靠
如果业务逻辑复杂（比如吸顶、嵌套滚动、需监听滚动事件），放弃 pageScrollTo，改用 <scroll-view scroll-y="true"></scroll-view> 包裹全部内容，并通过 scroll-top 响应式控制。这样兼容性好、可控性强，且能用 scroll-into-view 直接跳转到子元素。
-
scroll-into-view的值必须是元素id字符串（不能带#），且该元素必须在<scroll-view></scroll-view>内部 - 需手动绑定
scroll-top到 data，更新时触发视图重绘；直接赋值不会自动滚动，要配合this.$nextTick - 注意：iOS 微信中
scroll-into-view有延迟或失效问题，建议 fallback 到scroll-top计算
容易被忽略的细节
微信开发者工具里 pageScrollTo 可能表现正常，真机调试时却卡顿或偏移不准——这是因为真机上页面渲染节奏和查询时机更敏感。另外，pages.json 中若配置了 "navigationStyle": "custom"，部分安卓机型会干扰原生滚动行为；还有，使用 uni.navigateTo 跳转后立即执行 pageScrollTo，大概率失败，得等 onReady 或 $nextTick 后再调。
真正稳定的做法不是堆参数，而是先确认滚动上下文是否归页面所有，再决定走原生 page 还是自管 scroll-view。后者虽然多写几行，但一次写对，后续少踩坑。
