uni-app侧边栏联动核心是scroll-into-view+ref双向驱动：左侧点击跳转右侧，右侧滚动反向高亮左侧；须避坑scroll-y缺失、id非法、scrolltop手动设值卡顿；禁用onpagescroll，因仅适用于页面级滚动而非scroll-view内部。
uni-app里用scroll-view做分类侧边栏联动，核心就两件事
不是靠page-scroll事件硬监听，也不是用scrollTop反复设值——真正稳定的做法是：左侧菜单点击驱动右侧滚动，右侧滚动反向高亮左侧项。两者都走scroll-into-view + ref定位，避开手动计算滚动高度的坑。
常见错误现象：scroll-view没加scroll-y导致无法滚动；右侧列表id带中文或空格，scroll-into-view直接失效；用scrollTop动态设置时，在iOS上卡顿、跳动、甚至不响应。
- 右侧每个分类区块必须有唯一且合法的
id（纯字母/数字/下划线，如category-food） - 左侧菜单项绑定
@click="jumpTo('category-food')"，跳转函数里调this.$nextTick再执行scrollIntoView - 右侧
scroll-view需设:scroll-top="currentTop"并监听@scroll，但仅用于更新左侧高亮，不用于控制滚动
为什么不能用onPageScroll监听页面滚动来做联动
因为onPageScroll在scroll-view内部无效，它只响应整个页面的滚动（即pages.json里disableScroll: false时的page级滚动）。而美团式侧边栏99%跑在scroll-view里，否则无法固定左侧菜单、也无法精准锚点对齐。
真实场景中，用户快速滑动右侧列表时，onPageScroll根本收不到事件；即使能收到，它的scrollTop单位是px，和scroll-view的scrollTop数值也不一致，换算极易出错。
- 确认你用的是
scroll-view而不是整页滚动，检查模板里有没有<scroll-view scroll-y></scroll-view> - 如果误用了
onPageScroll，会发现iOS下完全不触发，Android下触发但位置偏移——这不是bug，是机制不匹配 - 替代方案只有监听
scroll-view自身的@scroll事件，取detail.scrollTop做判断
scroll-into-view在uni-app里容易被忽略的三个兼容性细节
这个API看着简单，但在不同端表现差异极大。最常踩的坑不是写法错，而是没处理好端间行为断层。
- H5端支持原生
scrollIntoView({ block: 'start' })，但App和小程序只认scroll-into-view属性绑定的id字符串，不支持配置对象 - 微信小程序要求目标
id必须在scroll-view子元素第一层，嵌套一层view就找不到——得写成<scroll-view><view id="xxx">...</view></scroll-view> - App端（尤其是iOS）对
scroll-into-view响应有延迟，必须配合this.$nextTick(() => { ... })，否则id还没渲染完成就去滚动，静默失败
双向联动的临界点判断怎么写才稳
右侧滚动时高亮左侧对应菜单，关键不在“滚到哪”，而在“当前可视区域覆盖了哪个区块”。别用scrollTop除以平均高度来猜——分类区块高度不一，顶部吸顶、间距、padding都会干扰。
正确做法是遍历所有分类区块的boundingClientRect，看哪个的top最接近0（即刚进入视口），再结合height判断是否过半。uni-app里用uni.createSelectorQuery()比getRect更可靠。
- 别在
@scroll里频繁调查询，加节流（比如setTimeout防抖300ms） - 查询时用
.exec回调，不要依赖async/await，uni-app旧版本不支持Promise化 - 高亮逻辑放在
then里，查到top 0的项就停，避免遍历全部
复杂点在于吸顶标题和空状态区块会打乱位置计算，这些节点得提前过滤掉。事情说清了就结束
