scroll-view + scroll-into-view 是唯一可靠路径：必须设显式高度、scroll-y="true"、:scroll-into-view 绑定 id，且 ios 需手动补偿 tabbar 偏移；索引栏需手写并节流处理 touchmove，首字母分组须动态提取去重。
scroll-view + scroll-into-view 是唯一可靠路径
别指望 recycle-list 或原生 list 组件支持索引跳转——它们不暴露锚点滚动能力，也不响应 scroll-into-view。必须用 scroll-view，且它得有显式高度：只写 flex: 1 或 height: 100vh 在 iOS/小程序里大概率失效。
关键约束有三个：scroll-y="true"、:scroll-into-view="scrollTargetViewId"、容器必须带固定 style="height: XXXrpx"（不能靠父级 flex 撑开）。否则 scrollTop 计算永远为 0，跳转无声无息。
- 安卓和 iOS 的可滚动区域计算不一致，iOS 在 tabBar 页面中底部默认被遮挡约 50px，但
boundingClientRect()不自动扣除 - 每个字母区块必须用
id="letter-A"这类格式声明，不能用动态 class 或 data 属性替代 -
scroll-into-view触发后不会自动高亮对应索引项，需手动维护activeLetter状态
右侧字母栏必须自己监听 touchmove
uni-app 没有内置“索引侧边栏”组件，scroll-view 自身也不提供滑动映射能力。你得用 view 手写一列字母，绑定 @touchstart 和 @touchmove，从 touches[0].pageY 反推当前触点对应的字母。
常见翻车点：touchmove 未调用 e.preventDefault()，导致页面跟着拖拽、索引条“飘走”；或者没做节流，手指一滑就触发几十次 scrollIntoView，UI 卡成幻灯片。
- 索引栏高度要均分，比如 26 个字母占满容器高，则每个
height = screenHeight / 26 - 计算字母下标时用
Math.floor((pageY - startY) / itemHeight)，别用四舍五入 -
touchend后记得清空activeLetter，否则松手后字母还亮着
首字母分组不能硬写 A-Z 数组
用户数据里可能压根没有 Z，也可能有「#」、「未知」或拼音首字为「嗯」「噢」的姓名。直接写 ['A', 'B', ..., 'Z'] 会导致索引栏出现无效项，点击后跳转失败或空白。
真实做法是遍历原始列表，提取每个项的首字符，再去重排序。中文取首字要用正则 name.match(/^[\u4e00-\u9fa5]/)?.[0]，英文才用 name.charAt(0).toUpperCase()。
- 分组逻辑放
computed，避免在methods中重复执行影响性能 - 后端若已返回分组数据，注意字段名可能叫
initial、firstLetter或groupKey，别默认用letter - 过滤掉空分组：
groups.filter(g => g.list.length)，否则索引栏会显示孤立字母
iOS 下滚动定位偏移必须手动补偿
哪怕你用 createSelectorQuery().select(`#letter-${letter}`).boundingClientRect() 拿到了正确 top 值，在 iOS 上仍可能偏差 40–50px——因为 tabBar 遮挡了可视区域，但查询结果没扣减这个 offset。
最稳方案是加一个平台判断偏移量：offsetTop: uni.getSystemInfoSync().platform === 'ios' ? -44 : 0，然后把查到的 top 减去它再赋给 scrollTargetViewId。
- 别依赖
scroll-top直接设值，它在某些版本 H5 下不触发动画；坚持用scroll-into-view - 如果跳转后位置仍不准，检查是否用了
position: sticky或transform影响了布局树计算 - 动态生成的 id（如
:id="'letter-' + letter"）要确保渲染完成后再查节点，必要时套this.$nextTick
