Safari 直到 macOS Sonoma 14.0 和 iOS 17 才原生支持 scroll-behavior: smooth，且仅限 html/body；对普通容器无效，且会静默忽略该声明；Element.scrollTo() 需同时满足：不设 scroll-behavior、目标元素可滚动、使用对象参数调用。
scroll-behavior: smooth 在 Safari 为什么完全不生效
因为 Safari 直到 macOS Sonoma（14.0）和 iOS 17 才原生支持 scroll-behavior: smooth，且仅限于 html 或 body 元素；对任意容器（如 overflow: auto 的 div）仍不支持。更关键的是：Safari 会直接忽略该声明，既不报错也不降级——你写了等于没写。
用 Element.scrollTo() 替代时的三个硬性条件
必须同时满足以下三点，scrollTo() 的 behavior: 'smooth' 才能在 Safari 触发平滑滚动：
-
scroll-behavior: smooth不需要、也不能设在父容器上（Safari 忽略它） - 目标元素必须有明确的
scrollLeft/scrollTop可写权限（即不能是overflow: hidden或未触发滚动上下文） - 必须使用对象参数调用：
el.scrollTo({ top: 100, behavior: 'smooth' })；传数字或数组（如scrollTo(0, 100)）会强制跳转
polyfill 选 smooth-scroll-polyfill 还是自己封装
推荐轻量封装而非引入全量 polyfill。原因很实际：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
-
smooth-scroll-polyfill依赖 MutationObserver，会在 Safari 中意外触发多次滚动回调，导致卡顿或偏移错乱 - 真正需要平滑滚动的场景通常只有几个锚点跳转，用
requestAnimationFrame+ 线性插值 30 行就能搞定 - 若需兼容旧版 iOS（scrollIntoView：检测
!('scrollBehavior' in document.documentElement.style)后，重写其行为
Safari 下 scrollIntoView({ behavior: 'smooth' }) 的兼容陷阱
这个 API 虽然支持较早（iOS 15.4+），但有两个隐藏坑：
立即学习“前端免费学习笔记（深入）”；
- 对
position: fixed容器内的元素，Safari 会错误计算滚动距离，结果滚过头或不到位 -
block: 'nearest'在 Safari 中表现不稳定，建议始终显式指定block: 'start'或block: 'center' - 如果目标元素在
display: none或visibility: hidden状态下调用，Safari 不抛错但静默失败——得先offsetParent !== null校验可见性
最稳妥的做法：只对已渲染、可测量、有滚动父级的元素调用，别指望它自动处理边界条件。
