编辑器内容区必须是可滚动容器，否则 scrollTop 始终为 0；需确保 overflow 为 auto/scroll、scrollHeight > clientHeight，且避免父级 transform 等截断滚动上下文，监听 scroll 事件应绑定到编辑器容器而非 window，并注意移动端 iOS Safari 的 scrollTop 跳变及动态内容导致的 scrollHeight 变化。
编辑器内容区必须是可滚动容器，否则 scrollTop 始终为 0
直接对 contenteditable 元素或 Monaco/CodeMirror 的外层容器调用 scrollTop，很可能返回 0——不是代码写错了，而是该元素根本不可滚动。常见原因包括：
-
overflow: hidden或overflow: visible（默认值），必须显式设为auto或scroll - 内容高度未超过容器高度：
scrollHeight <= clientHeight→ 滚动条不出现 →scrollTop无效 - 父级有
transform、contain: paint或position: fixed，会截断滚动上下文
验证方式：在 DevTools 控制台执行 el.scrollHeight > el.clientHeight，返回 true 才能继续。
监听 scroll 事件要绑定到编辑器容器，不是 window
HTML 编辑器（如 div[contenteditable]、.monaco-editor、.cm-editor）的滚动是局部的，window 的 scroll 事件完全不会触发。必须明确找到编辑器的可滚动容器再绑定：
- 用
editorElement.closest('[contenteditable], .monaco-editor, .cm-editor')定位最近滚动宿主 - 不要对
document.body或window绑定——它们和编辑器内部滚动无关 - React/Vue 中注意 ref 是否已挂载；若容器动态生成，需在 DOM 就绪后延迟绑定（如
setTimeout(() => ..., 0)）
示例：scrollableContainer.addEventListener('scroll', handler)，其中 handler 里读取的是 scrollableContainer.scrollTop，不是 window.pageYOffset。
立即学习“前端免费学习笔记（深入）”；
计算进度时别硬套全页公式，得用容器自身尺寸
全页阅读进度公式 scrollTop / (scrollHeight - clientHeight) 在编辑器内直接照搬会出错，因为：
-
clientHeight包含 padding 和 border，而可视区域实际可用高度是clientHeight - padding-top - padding-bottom - 编辑器可能有固定 header/footer，需预留偏移（比如工具栏高 48px，就应从
clientHeight中减去） - 某些编辑器（如 CodeMirror 6）用 canvas 渲染，
scrollHeight可能不准，得依赖其 API（如cm.getScrollInfo().height）
更稳妥的写法：const progress = Math.min(100, Math.round((container.scrollTop / (container.scrollHeight - container.clientHeight)) * 100))，但前提是已确认 scrollHeight > clientHeight。
移动端 iOS Safari 的 scrollTop 会跳变，需要 clamp 处理
iOS Safari 滚动到底部后拖拽回弹，scrollTop 可能短暂变成负值或超过最大值（scrollTop > scrollHeight - clientHeight），导致进度条闪动或卡在 100%。不能只靠 Math.min/max 一刀切：
- 先算理论最大值：
const maxScroll = Math.max(0, container.scrollHeight - container.clientHeight) - 再 clamp 当前值：
const clampedTop = Math.max(0, Math.min(container.scrollTop, maxScroll)) - 避免用
scrollend事件降级——iOS Safari 目前不支持，改用requestAnimationFrame节流 + 时间戳防抖更可靠
真正容易被忽略的是：编辑器内容动态加载（如懒加载段落）会导致 scrollHeight 突增，此时旧的 maxScroll 缓存失效，必须重新计算，否则进度条会“倒退”。
