uni.pageScrollTo 调用无反应的最常见原因是页面根节点非原生 容器，需确保启用原生滚动、目标元素在根节点内、Y 坐标计算准确；否则静默失效。
uni.pageScrollTo 能用，但必须满足三个前提：页面启用原生滚动、目标元素在根节点内、Y 坐标计算准确；否则它大概率静默失效。
uni.pageScrollTo 为什么调用没反应
最常见原因是页面根节点不是原生 <page></page> 容器。uni-app 默认生成的页面根是 <view></view> 或包裹了 <scroll-view></scroll-view>，此时 uni.pageScrollTo 失去作用对象。
- 检查
pages.json中对应页面配置是否含"disableScroll": false（默认即为 false，但若手动设为 true 就会禁用） - 确认页面
<template></template>最外层没有<scroll-view></scroll-view>或<swiper></swiper>等接管滚动的容器 - H5 端会 fallback 到
document.body滚动，但小程序（尤其微信）完全依赖原生 page 容器，不满足就无响应
如何正确获取目标元素的 scrollTop 值
uni.pageScrollTo 只接受数字型 scrollTop，不支持 selector 参数——写 { selector: '#target' } 会直接报错或忽略。
- 必须用
uni.createSelectorQuery()获取元素位置，且需在 DOM 渲染完成后执行，推荐在onReady或$nextTick后调用 -
boundingClientRect().top返回的是元素相对于视口顶部的距离，不是页面总滚动偏移；要得到真正需要的scrollTop，一般需加上当前已滚动距离：currentScrollTop + rect.top - 若页面有固定导航栏，还需减去
uni.getSystemInfoSync().navigationBarHeight，否则目标内容会被遮挡
示例：
onReady() {
this.$nextTick(() => {
uni.createSelectorQuery()
.select('#section2')
.boundingClientRect(rect => {
const navHeight = uni.getSystemInfoSync().navigationBarHeight
uni.pageScrollTo({
scrollTop: rect.top + window.pageYOffset - navHeight,
duration: 400
})
})
.exec()
})
}scroll-view 是唯一跨端可控方案
当 uni.pageScrollTo 因平台限制或布局复杂而不可靠时，<scroll-view></scroll-view> 是实际项目中最稳的选择。
- 必须显式设置
height（如:style="{ height: scrollViewHeight + 'px' }"），否则无法滚动 - 用
scroll-into-view属性可直接跳转到带id的子元素，但无平滑动画；需要动画就得配合scrollTop+scroll-with-animation="true" - 注意：不能把整个页面包进
<scroll-view></scroll-view>后还试图用uni.pageScrollTo，两者滚动上下文不同，会冲突
duration 参数的实际表现差异
duration 在不同平台效果不一致：微信小程序支持良好，H5 端部分基础库版本可能忽略该值，支付宝小程序则明确不支持。
- 设为
0是瞬移，设为300–600是较自然的区间 - 不要依赖它做精确计时控制，更别在
duration结束后立刻读取scrollTop——小程序里这个值可能还没更新 - 如需强一致性滚动逻辑（比如 Tab 同步高亮），建议监听
<scroll-view></scroll-view>的@scroll事件，而非依赖uni.pageScrollTo的完成回调
真正容易被忽略的是渲染时机与容器层级：哪怕代码全对，如果目标元素被 v-if 控制、或父级用了 transform、position: sticky，boundingClientRect 返回的 top 就会失真。这种问题只能靠真机调试+逐层检查样式来定位。
