局部滚动不生效主因是容器未被高度约束且未触发可滚动上下文；需确保容器有明确高度、祖先元素高度链完整、避免min-height误用、检查overflow:hidden及层叠上下文干扰，并在DOM就绪后通过requestAnimationFrame设置scrollTop。
局部滚动不生效，90% 是容器根本没“被框住”——它既没有明确高度约束，也没触发可滚动上下文，overflow-y: auto 就只是个摆设。
容器没高度，overflow-y: auto 就等于没写
只加 overflow-y: auto 绝对不够。浏览器必须能算出“内容比容器高”，才会启用滚动逻辑。常见失效场景：
- 父元素用
display: flex但没设height或overflow: hidden，子容器被拉伸或塌陷 - 用
height: 100%，但所有祖先都没给固定高度（比如html、body缺少height: 100%） - 用了
min-height：它不构成滚动上下文，内容一多就直接溢出到外部 - Safari 下偶发不显示滚动条？试试
overflow-y: scroll强制占位，或动态重设一次el.style.height = el.offsetHeight + 'px'
scrollTop 总是 0，说明容器压根没滚起来
不是 JS 写错了，是布局没达标。先查三件事：container.scrollHeight、container.clientHeight、container.scrollTop。如果前两者相等，或 scrollTop 始终为 0，那问题不在代码，在结构。
- 检查是否误用了
overflow: hidden—— 它会直接禁掉滚动能力 - 父级用了
transform、filter或contain: layout？这些会创建新层叠上下文，干扰滚动事件派发 - Vue/React 中绑定事件太早？等
mounted或useEffect完成、DOM 渲染完毕再获取尺寸 - 别在
touchmove里读scrollTop：它会强制同步 layout，卡顿明显；改用getBoundingClientRect()或IntersectionObserver
滚动能动但不平滑，scroll-behavior: smooth 没起作用
这个属性不继承，也不穿透父级。它必须显式写在那个带 overflow 的容器上，且该容器得先满足“能滚”的所有前提（高度 + 溢出）。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- 正确写法：
.chat-history { height: 300px; overflow-y: auto; scroll-behavior: smooth; } - 给
html或body设了，对.sidebar-menu这种局部容器完全无效 - 容器由框架动态创建（如
v-if切换），样式需在元素存在时已挂载；否则首次scrollIntoView()会硬跳 - 用户开启系统级“减少运动”偏好（
prefers-reduced-motion: reduce）时，该属性自动失效，这是正确行为，不用强行绕过
移动端滚动卡顿、松手即停、不回弹
这不是性能问题，是手势分发被阻断。iOS Safari 默认对局部容器启用 touch-action: none，尤其在某些 CSS 框架或重置样式里。
- 必须加这三行底线 CSS：
overflow-y: auto、-webkit-overflow-scrolling: unset、touch-action: pan-y - 禁用
-webkit-overflow-scrolling: touch（已废弃），它在 iOS 12–14 中会破坏弹性系数 - 若希望滚动到底部后继续拖拽能触发页面整体滚动，再加：
overscroll-behavior-y: auto - JS 层面不要干预
touchmove的滚动逻辑：禁止preventDefault()，也不要手动改scrollTop，这会切断原生滚动管线
最常被忽略的点是：滚动容器的高度必须在样式计算完成后再读取和设置，尤其是内容动态插入后。直接赋值 scrollTop 很可能无效，因为此时 scrollHeight 还没更新。用 requestAnimationFrame 等一帧，才是可靠时机。
