pageScrollTo不生效主因是页面未启用原生滚动：需在pages.json中设"disableScroll": false，且页面根节点须为原生而非或；H5可滚body，小程序则严格依赖原生容器。

uni-app 中 pageScrollTo 不生效的常见原因

直接调用 uni.pageScrollTo 却没反应？大概率是因为目标页面不是「滚动容器」——pageScrollTo 只对 根节点生效，而 uni-app 的页面默认根节点是 或 ，并非原生 page 级滚动。H5 和小程序表现还不一致：H5 下它会尝试滚动 document.body，但小程序（尤其是微信）严格依赖页面级滚动容器。

解决前提是确认当前页面启用了「原生页面滚动」：在 pages.json 中对应页面配置 "disableScroll": false（默认值），且不要包裹在 内；否则滚动权被子组件接管，pageScrollTo 就失效。

如何正确触发平滑滚动到指定位置

必须确保滚动目标在页面根节点内、且有足够高度可滚。推荐做法是：给目标元素加 id（如 ），再用 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
      })
    }
  })

替代方案：用 自控滚动更可靠

如果业务逻辑复杂（比如吸顶、嵌套滚动、需监听滚动事件），放弃 pageScrollTo，改用 包裹全部内容，并通过 scroll-top 响应式控制。这样兼容性好、可控性强，且能用 scroll-into-view 直接跳转到子元素。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

• scroll-into-view 的值必须是元素 id 字符串（不能带 #），且该元素必须在 内部
• 需手动绑定 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。后者虽然多写几行，但一次写对，后续少踩坑。