局部滚动容器的最大可滚动距离 maxscroll = scrollheight - clientheight，需确保容器有固定高度且 overflow-y 为 auto 或 scroll；scrolltop 超限会被浏览器自动截断，应手动钳制或用 scrollintoview() 替代。
局部滚动容器的 maxScroll 怎么算
局部滚动（比如一个 <div class="scroll-area">）的最大可滚动距离，不是用 <code>document.documentElement.scrollHeight，而是得看它自己内部内容高度和自身可视高度的差值。核心公式是：maxScroll = scrollHeight - clientHeight，其中两个值都必须从该容器元素上取。
常见错误是直接读 element.scrollHeight 却忘了检查 CSS：如果容器没设固定高度、或 overflow 不是 auto/scroll，clientHeight 可能等于 scrollHeight，导致 maxScroll 为 0 —— 滚不动。
-
scrollHeight是容器内所有子内容撑开后的总高度（含 padding，不含 margin） -
clientHeight是容器自身的可视区域高（含 padding，不含 border 和 scrollbar） - 必须确保容器有明确的
height或max-height，且overflow-y: auto或scroll - 若容器用了
transform、flex或grid布局，clientHeight仍可靠；但getBoundingClientRect().height可能受缩放/滚动影响，不建议替代
为什么 scrollTop 超过 maxScroll 还能设成功
给局部容器的 scrollTop 赋一个超过 maxScroll 的值（比如 el.scrollTop = 9999），浏览器不会报错，而是自动截断到最大允许值。这看似“安全”，但会掩盖逻辑问题——比如你本想滚动到某元素却因计算偏差设了过大值，结果停在底部，用户感知就是“跳过了目标”。
真正需要的是主动钳制：
- 手动赋值前做校验：
el.scrollTop = Math.min(maxScroll, Math.max(0, targetPos)) - 用
scrollIntoView()替代手动算位置，尤其适合锚点跳转场景 - 监听
scroll事件时，别依赖el.scrollTop === maxScroll判断是否到底 —— 某些浏览器（如 Safari）在快速滚动后可能短暂不精确，建议加Math.abs(el.scrollTop - maxScroll) 容差
动态内容插入后 maxScroll 失准怎么办
往局部滚动容器里用 JS 插入新 DOM（比如加载更多卡片）、或图片异步加载完成，都会改变 scrollHeight，但你之前缓存的 maxScroll 值就失效了。这时候再按旧值控制滚动，容易卡住或越界。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
解决思路不是“重新计算一次”，而是避免缓存：
- 每次需要用到最大滚动距离时，实时读取：
const maxScroll = el.scrollHeight - el.clientHeight - 如果性能敏感（比如在
scroll事件里高频读取），可用ResizeObserver监听容器尺寸变化，或在插入内容后手动触发一次更新 - 注意：
img加载完成可能触发重排，scrollHeight变更不一定同步触发resize事件，所以img.onload后应主动更新
移动端弹性滚动对 maxScroll 的影响
iOS Safari 和部分 Android WebView 支持弹性滚动（overscroll），即滚到顶/底后还能拖出一段“回弹区”。这时 scrollTop 可能短暂变成负数或超过 maxScroll，但松手后自动回弹。这不是 bug，是系统行为。
这意味着：
- 不要用
scrollTop 作为“已到顶部”的唯一判断依据；加个防抖或等 <code>scrollend事件（Chrome 120+/Safari 17.4+ 支持） -
scrollend触发时，scrollTop才是稳定值，此时再读maxScroll更可靠 - 若需禁用弹性滚动，在容器上加
overscroll-behavior: contain（注意兼容性：IE 不支持，旧版 Safari 需加-webkit-overscroll-behavior）
局部滚动的最大距离不是静态配置项，它随内容、样式、设备而变；最易被忽略的是“动态内容插入后不刷新 maxScroll”和“把 overscroll 状态误判为真实滚动位置”。这两处一旦出错，滚动逻辑就会在特定机型或操作路径下静默失效。
