必须在 shown.bs.modal 事件中调用 scrollintoview，因 modal 渲染完成前 dom 坐标不准；应使用 scroll-margin-top 而非 js 计算偏移，并避免 smooth 滚动与动画冲突。
shown.bs.modal 事件里调 scrollIntoView 才有效
Modal 自身不处理页面滚动，必须手动监听 shown.bs.modal 事件，在 Modal 完全渲染、尺寸可读之后再执行滚动逻辑。用 show.bs.modal 会失败——此时 DOM 还在 transition 中，getBoundingClientRect() 返回的坐标不准，scrollIntoView() 可能滚错位置或无效。
常见错误是把滚动写在按钮 click 回调里紧跟着 .modal('show') 调用，但这时 Modal 还没 append 到 body，目标元素可能不可见或未布局。
- 必须等
shown.bs.modal触发后再找锚点元素，比如document.getElementById('target-row') - 别用
{ behavior: 'smooth' }：它和 Modal 的 CSS 动画冲突，尤其在 Safari 下容易抖动或中断 - 优先用
{ block: 'center' }，比'start'更可靠，避免顶部被 sticky 导航遮挡
锚点偏移要靠 scroll-margin-top，不是 JS 算 top
想让锚点元素滚到视口中间但避开顶部导航栏？别在 JS 里手动减去 80px 高度再调 window.scrollTo()——这在 iOS 键盘弹出、地址栏收起时会失效，因为 window.innerHeight 动态变化，计算结果错乱。
正确做法是给锚点元素加 CSS：scroll-margin-top: 80px。浏览器原生支持，且在 resize、缩放、键盘弹出时自动重算，比 JS 更稳。
- 确保该样式作用于实际滚动目标元素，比如
#row-123 { scroll-margin-top: 80px; } - 不要设在
.modal或.modal-dialog上——它们不是滚动目标 - 如果锚点是动态插入的（如 AJAX 加载后生成），需确认样式已就位再触发
scrollIntoView
iOS Safari 下滚动 + Modal 组合容易闪屏
在 iOS Safari 中，scrollIntoView 可能因地址栏收起/展开触发两次滚动，导致 Modal 看起来“闪一下”或短暂错位。这不是代码 bug，而是浏览器对 viewport 变化的响应机制。
规避方式不是禁用滚动，而是控制触发时机和精度：
- 绝对不要在
show.bs.modal或loaded.bs.modal（非标准事件）里执行滚动 - 用
element.getBoundingClientRect().top替代window.scrollY + offset计算——它基于视口而非全局坐标，更抗干扰 - 如果 Modal 内容高度变化大（如加载富文本），先等内容渲染完成（可用
MutationObserver或setTimeout短延时兜底），再滚动
Modal 内部滚动和页面滚动别混淆
有人给 .modal-dialog 加 margin-top: 100px，以为这样就能“定位到锚点”，其实只是把 Modal 往下推，页面本身没滚动，锚点还在原处。用户仍需手动拖 scrollbar。
还有人试图在 Modal 内部用 overflow-y: auto 并滚动它，这解决的是 Modal 内容溢出问题，和页面锚点定位完全无关。
- 页面滚动由
window或document.scrollingElement控制，和 Modal 的 CSS 定位无关 - 若 Modal 内有长表单且需锚点跳转（如跳到某个 fieldset），那是内部滚动，应操作
.modal-body或具体子容器的scrollTop - 检查是否误把
data-bs-target指向了 Modal 内部 ID——这只会触发 Modal 显示，不会触发页面滚动
